dd

English | 한국어 | 中文 | 日本語 | Español

dd

Hand Claude Code a long log or a screenshot without pasting it into the chat.

Working in Claude Code, you paste a lot: error logs when something breaks, a reference when you're building, a screenshot to show what you want. dd reads that straight off the clipboard, keeps it in a local file, and passes the conversation only what it needs — sometimes by analyzing big material in the background and bringing back just the conclusion.

Quick Start • Why dd? • How it works • Features • Commands • Requirements

---

Quick Start

1. Add the marketplace

/plugin marketplace add https://github.com/fivetaku/gptaku_plugins.git

2. Install

/plugin install dd

3. Restart Claude Code

(New commands only register after a restart.)

4. Use it

Put something on your clipboard, then type /dd (or /ㅇㅇ) with your request — no pasting needed:

• Image — Windows: capture with Win+Shift+S, then /dd 왜 이렇게 보여? (the snip is already on the clipboard)
• Image — macOS: capture with Shift+Cmd+4, then /dd 이 레퍼런스처럼 만들어줘 (one-time setup: make screenshots save to the clipboard — screenshot toolbar Shift+Cmd+5 → Options → Save to: Clipboard)
• Long text / error log: copy it, then /dd 무슨 에러야? — it never lands in the chat as a wall of text, so the session stays small
• No request: just /dd — it reads the clipboard and continues from the conversation

In a Korean IME you can type /dd as-is — it comes out as /ㅇㅇ, same thing. No language switching.

---

Why dd?

Working in Claude Code, you paste all the time. An error log when something breaks, a reference when you're building, a screenshot to show the look you're after. Pasting it all straight into the chat runs into two problems.

Long text eats the conversation. Drop a big log in once and it stays there, taking up room and getting re-read every turn, so the session slowly gets slower and pricier. dd keeps the full text in a file, hands Claude a short summary, and reads more only when the task needs it.

Images often won't paste at all. Depending on your setup, Claude Code may not take a pasted image. dd reads the clipboard directly, so you just capture and type /dd. A copied image file comes in as the real picture, not its icon.

You also stop repeating yourself: no "the error I just copied" or "the reference above." And if dd grabs the wrong thing (the clipboard has no timestamp), it shows what it got and asks first.

The name dd doesn't stand for anything. You reach for it often and typing something long every time is a pain, so it's just two quick taps. (In a Korean IME those same keys come out as ㅇㅇ, which works the same.)

---

How it works

copy / screenshot
   → /dd [request]
   → dd_clipboard.py captures the current clipboard into ~/dd/<date>/<id>/
       · text → content.txt   image → image.png   + manifest.json
   → Claude reads the manifest summary (not the full content)
   → shows what it grabbed; confirms if it looks wrong; otherwise acts

The OS clipboard holds only the most recent copy (no history). dd always captures that current item, redacts secrets from the preview, and cleans up captures older than 7 days.

---

Features

Feature	Description
Text & image capture	macOS / Windows / WSL / Linux clipboard, text or image
Instruction-pattern injection	Captures on every /dd via ${CLAUDE_PLUGIN_ROOT} — works for everyone
Confirm gate	Asks before acting only when the clipboard looks unrelated or ambiguous
Lazy reading	Reads by size_class so a huge paste never floods context
Secret redaction	api_key, Bearer, sk-, ghp_, xoxb-, etc. masked in preview
Auto cleanup	Captures older than DD_RETENTION_DAYS (default 7) deleted on each run
Background analysis	Big logs or images get analyzed in a subagent, so only the result enters the chat
Replies in your language	Answers in the language of your request, or the conversation's language when there's none

---

Commands

Command	Description
/dd [request]	Capture the current clipboard and act on it
/ㅇㅇ [request]	Same as /dd (Hangul-mode alias)

Natural language triggers

• "방금 캡처한 거 분석해줘", "이 레퍼런스로 만들어줘", "스크린샷 드롭"
• "drop clipboard", "use what I copied", "this screenshot"

---

Requirements

• Claude Code CLI
• Python 3 (standard library only)
• macOS: works out of the box (pbpaste / osascript)
• Windows / WSL: PowerShell (built in) — user-verified
• Linux: a clipboard tool installed (xclip / wl-clipboard) and a graphical session