Ten Four

"10-4, copy that." A shelf of clean, copyable snippets, pushed from your terminal or from Claude Code, browsed and copied from Raycast.

When a tool prints something you want to copy (a URL, an API key, a command, a code block), copying it straight out of the terminal gives you mangled line breaks and stray indentation, because you're selecting reflowed text off the character grid. Ten Four fixes the root cause: snippets travel as data, never as rendered terminal text. You copy them out of Raycast with the exact bytes intended, with no wrapping and no leading spaces.

Demo

Claude Code answers a question and pushes the SQL query onto the shelf on its own. You grab it from Raycast and paste it, clean, into your SQL console.

How it works

There are two shelves, and you pick one with a single preference.

Local (the default, zero setup). The CLI and the extension share a JSON file on your Mac:

your terminal / Claude Code  ──tenfour──▶  ~/.ten-four.json  ──▶  Raycast "Ten Four"

Remote (push from another machine). Run the small HTTP service (see server/) on an always-on host, expose /shelf over your tailnet with tailscale serve, then point TENFOUR_URL (CLI) and the extension's Shelf URL preference at it:

your dev box / Claude Code  ──tenfour──▶  shelf service (/shelf)  ──▶  Raycast "Ten Four"
                             (TENFOUR_URL)   tailnet, owns the store     (Shelf URL pref)

Set the Shelf URL preference and you are in remote mode; leave it blank and you are in local mode. Either way snippets travel as data, so you copy them out of Raycast with pristine formatting.

• Ten Four (Raycast extension): a searchable list of your snippets. Hit your Raycast hotkey, type a letter or two, press ↵ to copy (or ⌘ to paste into the front app).

Install

Option A: Raycast Store (one click)

Click Add to Raycast above, or search "Ten Four" in the Raycast Store. Then run the Install Ten Four CLI command to add the tenfour writer.

Option B: From source

Requires Node.js and the Raycast app.

git clone https://github.com/berwickgeek/ten-four.git
cd ten-four
npm ci
npm run dev

npm run dev builds the extension and registers it in Raycast immediately. It stays installed even after you stop the dev server (Raycast keeps its own compiled copy), so you only need to run this once. You can then close the terminal.

Then install the CLI either way:

• In Raycast, open Install Ten Four CLI and click Install CLI, or
• From the repo: ./install.sh (symlinks assets/tenfour into your PATH).

Usage

tenfour "https://my-app.up.railway.app"          # label = first line
tenfour --label "API key" "sk-live-…"            # explicit label
printf 'def hi():\n    return 1\n' | tenfour -l "snippet" -   # multiline via stdin
tenfour list                                     # print the shelf
tenfour clear                                    # empty the shelf

Then summon Raycast → Ten Four Shelf → copy.

Use with Claude Code

The reliable way is a sentinel marker plus a Stop hook: Claude wraps any snippet in an invisible HTML comment, and the hook scrapes it onto the shelf automatically, so it cannot be forgotten the way a manual CLI call can.

Add this to your CLAUDE.md:

When you output a snippet I'm likely to want to copy (a URL, token, command,
path, or code block), wrap it in a sentinel marker:

  <!--shelf:Short Label-->

... the exact text ...

  <!--/shelf-->

The markers render as nothing in the terminal, so I still see a clean snippet.

Then wire the hook in ~/.claude/settings.json so it fires on every turn:

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          { "type": "command", "command": "~/.claude/hooks/shelf-push.sh" }
        ]
      }
    ]
  }
}

The hook scans each assistant message for <!--shelf:…--> blocks, strips any code fence, and pushes the contents via tenfour. It dedups by content hash, so re-fires never double-push.

For scripts and one-offs where the marker can't reach, call the CLI directly:

tenfour --label "<short label>" "<the exact text>"

Don't do both for the same snippet: a manual push bypasses the hook's hash log and double-pushes.

Configuration

Local mode needs no configuration at all. For remote mode:

• CLI endpoint: set TENFOUR_URL to your shelf service URL (e.g. https://<your-host>.ts.net/shelf). Unset, the CLI writes the local file.
• Shelf token: generate and set TENFOUR_TOKEN on the shelf service, then set that same value in TENFOUR_TOKEN for remote CLI commands and Raycast's Shelf Token preference.
• Extension endpoint: set the Shelf URL preference in Raycast to the same URL. Blank, the extension reads the local file.
• Storage: snippets live at ~/.ten-four.json (override with TENFOUR_FILE), on your Mac in local mode or on the server host in remote mode. The service listens on port 7801 (override with PORT). See server/README.md for setup.
• The shelf keeps the most recent 200 snippets; pinned snippets are never trimmed.

Notes

• The CLI is Node.js (zero dependencies) so it can ship as a single file inside the extension. It requires node on your PATH. A future Go rewrite would allow a dependency-free Homebrew bottle.

License

MIT