From 6c8693c3c67f4b7e4ef0bae2a6ba672a95480d8a Mon Sep 17 00:00:00 2001 From: Penguin Date: Sat, 29 Aug 2026 22:35:40 +0900 Subject: [PATCH 1/2] =?UTF-8?q?docs:=20README=20=EB=8B=A4=EC=84=AF?= =?UTF-8?q?=EC=97=90=20=E2=8C=A5=E2=8F=8E=20=EB=8B=A8=EC=88=9C=20=EB=B3=B5?= =?UTF-8?q?=EC=82=AC=EB=A5=BC=20=EC=A0=81=EB=8A=94=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit #69가 ⌥⏎(프롬프트·펜스·File:/Lines: 머리말 없이 잡은 코드만 복사)를 추가했는데 사용자 문서 어디에도 없었다. 루트 README와 번역 4종은 grab 흐름을 "Enter를 누르면 한 덩어리"까지 설명하므로, 두 출력 형식이 나란히 읽히도록 바로 그 문장 뒤에 한 문장씩 붙인다. macOS ⌥, Windows·Linux Alt를 함께 적는다. docs-flags-parity 게이트는 CLI 플래그만 대조하므로 이 누락을 원리적으로 잡지 못한다 — 게이트가 감시하지 않는 표면이라 손으로 챙긴다. apps/viewer/README.md(npm 페이지)는 grab을 아예 다루지 않아 대상이 아니다. Co-Authored-By: Claude Opus 5 (1M context) Claude-Session: https://claude.ai/code/session_01PaHtxdofJX6EvH7BWXgYKX --- README.md | 2 +- docs/README.es.md | 2 +- docs/README.ja.md | 2 +- docs/README.ko.md | 2 +- docs/README.zh.md | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 8729429..4fdbd55 100644 --- a/README.md +++ b/README.md @@ -45,7 +45,7 @@ Picking a branch compares against the **merge base** — the commit your work fo ### Grab — hand a diff selection to your coding agent -Select code in the diff and a prompt box opens right where you released the drag. Press Enter and diffdeck copies **one block** to your clipboard — the file reference, the exact lines you picked, and your prompt — ready to paste into Claude Code, Codex, or any chat. +Select code in the diff and a prompt box opens right where you released the drag. Press Enter and diffdeck copies **one block** to your clipboard — the file reference, the exact lines you picked, and your prompt — ready to paste into Claude Code, Codex, or any chat. Need only the code? Press ⌥Enter (AltEnter on Windows/Linux) and diffdeck copies the picked lines by themselves — no prompt, no fence, no file header — to paste straight into an editor. ![Grab — lines highlighted in the diff with the prompt box open beside them](docs/grab.png) diff --git a/docs/README.es.md b/docs/README.es.md index 6a2a960..1b8c017 100644 --- a/docs/README.es.md +++ b/docs/README.es.md @@ -45,7 +45,7 @@ Al elegir una rama, la comparación es contra la **merge base**: el commit del q ### Grab — envía una selección del diff a tu agente de código -Selecciona código en el diff y se abre un cuadro de prompt justo donde soltaste el arrastre. Pulsa Enter y diffdeck copia **un solo bloque** al portapapeles — la referencia del archivo, las líneas exactas que elegiste y tu prompt — listo para pegar en Claude Code, Codex o cualquier chat. +Selecciona código en el diff y se abre un cuadro de prompt justo donde soltaste el arrastre. Pulsa Enter y diffdeck copia **un solo bloque** al portapapeles — la referencia del archivo, las líneas exactas que elegiste y tu prompt — listo para pegar en Claude Code, Codex o cualquier chat. ¿Solo quieres el código? Pulsa ⌥Enter (AltEnter en Windows/Linux) y diffdeck copia únicamente las líneas elegidas —sin prompt, sin delimitadores de código ni encabezado de archivo— para pegarlo directamente en un editor. ![Grab — líneas resaltadas en el diff con el cuadro de prompt abierto al lado](grab.png) diff --git a/docs/README.ja.md b/docs/README.ja.md index e77ba0d..9d48dfb 100644 --- a/docs/README.ja.md +++ b/docs/README.ja.md @@ -45,7 +45,7 @@ diff レンダリングエンジンが提供する機能: ### Grab — diff の選択範囲をコーディングエージェントへ -diff 内でコードをドラッグして離すと、その位置にプロンプト入力欄が開きます。Enter を押すと、ファイル参照・選択した行・プロンプトが**ひとかたまり**でクリップボードにコピーされ、Claude Code や Codex にそのまま貼り付けられます。 +diff 内でコードをドラッグして離すと、その位置にプロンプト入力欄が開きます。Enter を押すと、ファイル参照・選択した行・プロンプトが**ひとかたまり**でクリップボードにコピーされ、Claude Code や Codex にそのまま貼り付けられます。 コードだけが欲しいときは ⌥Enter（Windows・Linux は AltEnter）。プロンプトもコードフェンスもファイル見出しも付かず、選んだ行だけがコピーされ、エディタにそのまま貼り付けられます。 ![Grab — diff 内でハイライトされた行と、その隣に開いたプロンプト入力欄](grab.png) diff --git a/docs/README.ko.md b/docs/README.ko.md index 07c10d3..da6f8db 100644 --- a/docs/README.ko.md +++ b/docs/README.ko.md @@ -45,7 +45,7 @@ diff 렌더링 엔진이 제공하는 기능: ### Grab — diff 선택을 코딩 에이전트에게 넘기기 -diff에서 코드를 드래그해 놓으면 그 자리에 프롬프트 창이 뜹니다. Enter를 누르면 파일 참조·잡은 줄·프롬프트가 **한 덩어리**로 클립보드에 복사되어 Claude Code나 Codex에 바로 붙여넣을 수 있습니다. +diff에서 코드를 드래그해 놓으면 그 자리에 프롬프트 창이 뜹니다. Enter를 누르면 파일 참조·잡은 줄·프롬프트가 **한 덩어리**로 클립보드에 복사되어 Claude Code나 Codex에 바로 붙여넣을 수 있습니다. 코드만 필요하다면 ⌥Enter(Windows·Linux는 AltEnter)를 누르세요. 프롬프트도 코드펜스도 파일 머리말도 없이 잡은 줄만 복사되어 편집기에 그대로 붙여넣을 수 있습니다. ![Grab — diff에서 하이라이트된 줄과 그 옆에 열린 프롬프트 창](grab.png) diff --git a/docs/README.zh.md b/docs/README.zh.md index fbe6ecf..ec14fae 100644 --- a/docs/README.zh.md +++ b/docs/README.zh.md @@ -45,7 +45,7 @@ diff 渲染引擎提供的功能： ### Grab — 把 diff 选区交给编码智能体 -在 diff 中拖选代码并松开，提示输入框会就地打开。按 Enter，diffdeck 会把文件引用、你选中的确切行以及你的提示**合成一段**复制到剪贴板，可直接粘贴到 Claude Code、Codex 或任意对话中。 +在 diff 中拖选代码并松开，提示输入框会就地打开。按 Enter，diffdeck 会把文件引用、你选中的确切行以及你的提示**合成一段**复制到剪贴板，可直接粘贴到 Claude Code、Codex 或任意对话中。 只想要代码？按 ⌥Enter（Windows/Linux 为 AltEnter），diffdeck 只复制你选中的行 —— 不带提示词、代码围栏和文件标题 —— 即可直接粘贴进编辑器。 ![Grab — diff 中高亮的行，以及旁边打开的提示输入框](grab.png) From 72d0121e8586d237d0df6f771106aac437bbebfc Mon Sep 17 00:00:00 2001 From: Penguin Date: Sat, 29 Aug 2026 22:57:54 +0900 Subject: [PATCH 2/2] =?UTF-8?q?docs:=20=EB=A6=AC=EB=B7=B0=20=EC=A7=80?= =?UTF-8?q?=EC=A0=81=EC=9D=84=20=EB=B0=98=EC=98=81=ED=95=98=EA=B3=A0=20SKI?= =?UTF-8?q?LL.md=EC=97=90=EB=8F=84=20=E2=8C=A5=E2=8F=8E=EB=A5=BC=20?= =?UTF-8?q?=EC=A0=81=EB=8A=94=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 번역 교정(리뷰에서 실측으로 지적된 것만): - ja·zh: 문장을 잇느라 `。` 뒤에 ASCII 공백이 들어갔다. 각 파일에서 유일한 사례였고(ja 49개 중 1, zh 46개 중 1) 전각 마침표는 자체 여백을 가지므로 다른 문장 경계보다 눈에 띄게 벌어졌다. 공백을 뺀다. - es: `las líneas`(여성 복수)를 받는데 `pegarlo`(남성 단수)라 성수가 어긋났다 → `pegarlas`. em-dash도 파일 관례(공백 있는 ` — `, 22곳)에 맞춘다. - zh: 같은 문단이 이미 쓰는 `提示`를 두고 `提示词`를, 29행이 쓰는 `文件头`를 두고 `文件标题`를 새로 만들었다. 파일 어휘로 되돌리고 `即可`도 `可`로. - ja: 명사구로 끝나 다른 문장(`…を押すと、…されます`)과 호흡이 달랐다. 같은 구조로 고치고 `選んだ行`도 이미 쓰는 `選択した行`으로 통일한다. 정확성: - 다섯 문서 전부에 mixed 선택 단서를 붙인다. plainSnippet은 양쪽에 걸친 선택에서 `+`/`-` 마커를 의도적으로 뺀다(encode.ts). 그래서 "편집기에 그대로" 라는 약속이 그 경우엔 어긋난다 — 같은 줄의 옛/새 버전이 잇달아 놓인다. SKILL.md(제외했다가 뒤집는다): - 59행이 "Grab copies a single fenced block plus the prompt"라고 무조건 단언해 ⌥⏎ 이후로는 과장이 됐다 → "Pressing Enter copies…"로 한정. - 더 중요한 건 형식 위험이다: 이 문서는 크로스사이드 블록에서 `-`/`+`/공백 접두를 벗기라고 지시하는데, ⌥⏎ 산출물은 이미 벗겨져 있어 그 규칙을 그대로 적용하면 에이전트가 옛/새 줄을 연속된 파일 내용으로 오독한다. 그 규칙 바로 뒤에 예외와 "어느 파일·어느 side인지 먼저 물어라"를 적는다. Co-Authored-By: Claude Opus 5 (1M context) Claude-Session: https://claude.ai/code/session_01PaHtxdofJX6EvH7BWXgYKX --- README.md | 2 +- docs/README.es.md | 2 +- docs/README.ja.md | 2 +- docs/README.ko.md | 2 +- docs/README.zh.md | 2 +- skills/diffdeck/SKILL.md | 11 ++++++++++- 6 files changed, 15 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 4fdbd55..dca1b75 100644 --- a/README.md +++ b/README.md @@ -45,7 +45,7 @@ Picking a branch compares against the **merge base** — the commit your work fo ### Grab — hand a diff selection to your coding agent -Select code in the diff and a prompt box opens right where you released the drag. Press Enter and diffdeck copies **one block** to your clipboard — the file reference, the exact lines you picked, and your prompt — ready to paste into Claude Code, Codex, or any chat. Need only the code? Press ⌥Enter (AltEnter on Windows/Linux) and diffdeck copies the picked lines by themselves — no prompt, no fence, no file header — to paste straight into an editor. +Select code in the diff and a prompt box opens right where you released the drag. Press Enter and diffdeck copies **one block** to your clipboard — the file reference, the exact lines you picked, and your prompt — ready to paste into Claude Code, Codex, or any chat. Need only the code? Press ⌥Enter (AltEnter on Windows/Linux) and diffdeck copies the picked lines by themselves — no prompt, no fence, no file header — to paste straight into an editor. A selection spanning both sides of the diff comes across without its `+`/`-` markers, so the old and new versions of a line sit one after another. ![Grab — lines highlighted in the diff with the prompt box open beside them](docs/grab.png) diff --git a/docs/README.es.md b/docs/README.es.md index 1b8c017..4603898 100644 --- a/docs/README.es.md +++ b/docs/README.es.md @@ -45,7 +45,7 @@ Al elegir una rama, la comparación es contra la **merge base**: el commit del q ### Grab — envía una selección del diff a tu agente de código -Selecciona código en el diff y se abre un cuadro de prompt justo donde soltaste el arrastre. Pulsa Enter y diffdeck copia **un solo bloque** al portapapeles — la referencia del archivo, las líneas exactas que elegiste y tu prompt — listo para pegar en Claude Code, Codex o cualquier chat. ¿Solo quieres el código? Pulsa ⌥Enter (AltEnter en Windows/Linux) y diffdeck copia únicamente las líneas elegidas —sin prompt, sin delimitadores de código ni encabezado de archivo— para pegarlo directamente en un editor. +Selecciona código en el diff y se abre un cuadro de prompt justo donde soltaste el arrastre. Pulsa Enter y diffdeck copia **un solo bloque** al portapapeles — la referencia del archivo, las líneas exactas que elegiste y tu prompt — listo para pegar en Claude Code, Codex o cualquier chat. ¿Solo quieres el código? Pulsa ⌥Enter (AltEnter en Windows/Linux) y diffdeck copia únicamente las líneas elegidas — sin prompt, sin delimitadores de código ni encabezado de archivo — para pegarlas directamente en un editor. Eso sí, una selección que abarque ambos lados del diff llega sin sus marcadores `+`/`-`, de modo que las versiones antigua y nueva de una misma línea quedan una tras otra. ![Grab — líneas resaltadas en el diff con el cuadro de prompt abierto al lado](grab.png) diff --git a/docs/README.ja.md b/docs/README.ja.md index 9d48dfb..852e623 100644 --- a/docs/README.ja.md +++ b/docs/README.ja.md @@ -45,7 +45,7 @@ diff レンダリングエンジンが提供する機能: ### Grab — diff の選択範囲をコーディングエージェントへ -diff 内でコードをドラッグして離すと、その位置にプロンプト入力欄が開きます。Enter を押すと、ファイル参照・選択した行・プロンプトが**ひとかたまり**でクリップボードにコピーされ、Claude Code や Codex にそのまま貼り付けられます。 コードだけが欲しいときは ⌥Enter（Windows・Linux は AltEnter）。プロンプトもコードフェンスもファイル見出しも付かず、選んだ行だけがコピーされ、エディタにそのまま貼り付けられます。 +diff 内でコードをドラッグして離すと、その位置にプロンプト入力欄が開きます。Enter を押すと、ファイル参照・選択した行・プロンプトが**ひとかたまり**でクリップボードにコピーされ、Claude Code や Codex にそのまま貼り付けられます。コードだけが欲しいときに ⌥Enter（Windows・Linux は AltEnter）を押すと、プロンプトもコードフェンスもファイル見出しも付かず、選択した行だけがコピーされ、エディタにそのまま貼り付けられます。ただし diff の両側にまたがる選択は `+`/`-` マーカーなしでコピーされるため、同じ行の変更前と変更後が続けて並びます。 ![Grab — diff 内でハイライトされた行と、その隣に開いたプロンプト入力欄](grab.png) diff --git a/docs/README.ko.md b/docs/README.ko.md index da6f8db..147fcc6 100644 --- a/docs/README.ko.md +++ b/docs/README.ko.md @@ -45,7 +45,7 @@ diff 렌더링 엔진이 제공하는 기능: ### Grab — diff 선택을 코딩 에이전트에게 넘기기 -diff에서 코드를 드래그해 놓으면 그 자리에 프롬프트 창이 뜹니다. Enter를 누르면 파일 참조·잡은 줄·프롬프트가 **한 덩어리**로 클립보드에 복사되어 Claude Code나 Codex에 바로 붙여넣을 수 있습니다. 코드만 필요하다면 ⌥Enter(Windows·Linux는 AltEnter)를 누르세요. 프롬프트도 코드펜스도 파일 머리말도 없이 잡은 줄만 복사되어 편집기에 그대로 붙여넣을 수 있습니다. +diff에서 코드를 드래그해 놓으면 그 자리에 프롬프트 창이 뜹니다. Enter를 누르면 파일 참조·잡은 줄·프롬프트가 **한 덩어리**로 클립보드에 복사되어 Claude Code나 Codex에 바로 붙여넣을 수 있습니다. 코드만 필요하다면 ⌥Enter(Windows·Linux는 AltEnter)를 누르세요. 프롬프트도 코드펜스도 파일 머리말도 없이 잡은 줄만 복사되어 편집기에 그대로 붙여넣을 수 있습니다. 다만 diff의 양쪽에 걸친 선택은 `+`/`-` 마커 없이 복사되므로, 같은 줄의 옛 버전과 새 버전이 잇달아 놓입니다. ![Grab — diff에서 하이라이트된 줄과 그 옆에 열린 프롬프트 창](grab.png) diff --git a/docs/README.zh.md b/docs/README.zh.md index ec14fae..ceb63bc 100644 --- a/docs/README.zh.md +++ b/docs/README.zh.md @@ -45,7 +45,7 @@ diff 渲染引擎提供的功能： ### Grab — 把 diff 选区交给编码智能体 -在 diff 中拖选代码并松开，提示输入框会就地打开。按 Enter，diffdeck 会把文件引用、你选中的确切行以及你的提示**合成一段**复制到剪贴板，可直接粘贴到 Claude Code、Codex 或任意对话中。 只想要代码？按 ⌥Enter（Windows/Linux 为 AltEnter），diffdeck 只复制你选中的行 —— 不带提示词、代码围栏和文件标题 —— 即可直接粘贴进编辑器。 +在 diff 中拖选代码并松开，提示输入框会就地打开。按 Enter，diffdeck 会把文件引用、你选中的确切行以及你的提示**合成一段**复制到剪贴板，可直接粘贴到 Claude Code、Codex 或任意对话中。只想要代码？按 ⌥Enter（Windows/Linux 为 AltEnter），diffdeck 只复制你选中的行 —— 不带提示、代码围栏和文件头 —— 可直接粘贴进编辑器。不过跨越 diff 两侧的选区不会带上 `+`/`-` 标记，因此同一行的旧版本与新版本会前后相邻。 ![Grab — diff 中高亮的行，以及旁边打开的提示输入框](grab.png) diff --git a/skills/diffdeck/SKILL.md b/skills/diffdeck/SKILL.md index 95cfe3f..ea6c173 100644 --- a/skills/diffdeck/SKILL.md +++ b/skills/diffdeck/SKILL.md @@ -56,7 +56,8 @@ press Enter — that copies one block for them to paste back to you. ## When the human pastes a "diffdeck selection" -Grab copies a single fenced block plus the human's prompt on the line after it: +Pressing Enter copies a single fenced block plus the human's prompt on the line +after it: ````text ``` @@ -89,6 +90,14 @@ need not match the working tree (and with `, deleted` the path may be gone); and the prompt is **optional**, so a block with nothing after the fence means the human hasn't said what they want yet. Ask rather than inventing a task. +The human can also press ⌥⏎ (Alt+Enter) to copy the picked code **alone** — no +fence, no `diffdeck selection`/`File:`/`Lines:` lines, and no `-`/`+`/space +prefix even when the selection spans both sides. Such a paste is bare code: it +says nothing about where it came from, and a both-sides selection arrives with +the old and new versions of the same lines one after another — so the +strip-the-first-character rule above does not apply to it. Ask which file, and +which side, before acting on it. + ## Options - `--port ` — serve on a specific port (default 49573, or `$DIFFDECK_PORT`).