clipboard

Clipboard

Copy the most recent relevant text block from the conversation to the macOS system clipboard.

Plain Text Copy (Default)

Use a heredoc to safely handle special characters (quotes, apostrophes, backticks, dollar signs):

cat <<'CLIPBOARD' | pbcopy
<text to copy>
CLIPBOARD

Rich Text Copy (Formatted)

Use when the user wants formatting preserved for pasting into Slack, Word, Google Docs, Notion, etc. Sets both HTML and plain text on the clipboard via Swift, so the receiving app picks the richest format it supports.

Step 1: Write the HTML content to a temp file:

cat <<'CLIPBOARD_HTML' > /tmp/_clipboard_rich.html
<html><body>
<h2>Title</h2>
<p>Paragraph with <b>bold</b> and <i>italic</i>.</p>
<ul><li>Item one</li><li>Item two</li></ul>
</body></html>
CLIPBOARD_HTML

Step 2: Write the plain text fallback to a temp file:

cat <<'CLIPBOARD_TEXT' > /tmp/_clipboard_rich.txt
Title

Paragraph with bold and italic.

- Item one
- Item two
CLIPBOARD_TEXT

Step 3: Set clipboard with both HTML and plain text using Swift:

swift -e '
import AppKit

let html = try Data(contentsOf: URL(fileURLWithPath: "/tmp/_clipboard_rich.html"))
let text = try String(contentsOfFile: "/tmp/_clipboard_rich.txt", encoding: .utf8)

let pb = NSPasteboard.general
pb.clearContents()
pb.setData(html, forType: .html)
pb.setString(text, forType: .string)
'

Step 4: Clean up temp files:

rm -f /tmp/_clipboard_rich.html /tmp/_clipboard_rich.txt

When to Use Rich vs Plain

• Rich: User says "copy formatted", "copy as rich text", "copy for Word/Stripe/Docs", or the content has meaningful formatting (tables, bold, headers, lists, code blocks)
• Plain: Default for code snippets, terminal output, simple text, or when user says "copy to clipboard" without formatting context

Rules

1. Identify the most recent text block the user wants copied (message, code block, drafted text, etc.)
2. If ambiguous, ask what to copy
3. Use single-quoted heredoc delimiters ('CLIPBOARD', 'CLIPBOARD_HTML', 'CLIPBOARD_TEXT') to prevent shell expansion
4. For rich copy, convert markdown-style content to proper HTML (use <b>, <i>, <code>, <table>, <ul>/<li>, <h1>-<h6>, <pre>, etc.)
5. Always provide a plain text fallback alongside HTML
6. Confirm success after copying, noting whether plain or rich format was used