Command line
Your clipboard from the terminal.
justcopy talks to the same local server the AI tools use. Same port, same token, same privacy gate, same switches, same activity log.
~/.local/bin/justcopy to the copy inside the app. No password, no Node, nothing downloaded. It needs the server on: “Let AI assistants read my clipboard”. When it is off, or the app isn’t running, every command says so.The commands
justcopy list [-n N] [--board NAME] [--kind KIND] [--json]
justcopy get <id|N> [--json]
justcopy search <query…> [-n N] [--json]
justcopy put [--board NAME] [--kind text|link|color] [--title T] [--from NAME] [--copy] [text…]
justcopy context [--board NAME | --last N] [--max CHARS]
justcopy boards [--json]
justcopy status
justcopy --helplist
The newest cards, 1 = newest. --board NAME lists a board instead, with its note above the list. --kind filters: text, rtf, image, file, link, color. -n up to 50, default 20.
get
One card’s text to stdout, pbpaste-compatible: the text and nothing else, so justcopy get 1 | pbcopy puts the newest card back on the clipboard. N is a position; an id is C_… from list or search. An image prints the text read from it.
search
Free-text search across card text and the text inside images. -n up to 50.
put
Add a card. Text comes from the arguments, or from stdin when there are none: git log -1 | justcopy put. Needs “Let tools add cards” on.
| --board NAME | also file a copy into that board |
|---|---|
| --kind | text (default) · link · color |
| --title T | a short label, up to 120 characters |
| --from NAME | label the card as coming from NAME, a script’s name, say; it is badged with the Terminal icon either way |
| --copy | also put the text on the system clipboard |
The server’s limits apply: 100,000 characters per card, 30 cards a minute. Text shaped like a key is stored concealed, and the command says so.
context
The Copy for AI block to stdout: one document with a header and every card oldest first. --board NAME for a board, or history; else --last N, default 20, up to 200. --max CHARS caps the length.
justcopy context --board Research > research.md
justcopy context --last 10 | pbcopyboards, status
boards lists every board with its count, whether it fills itself, and its note. status says whether the server is reachable, its port, how many cards are readable, and whether tools may add cards.
Exit codes
0 ok · 1 the server refused, with the reason on stderr: an unknown board, adding cards switched off · 2 can’t reach Just Copy: the server is off, the app isn’t running, or the token was refused · 64 usage.
Privacy
Cards Just Copy keeps private, concealed cards, cards from excluded apps, anything shaped like a key or token, never appear in any command, exactly as with the AI tools. Text you put that looks like a secret becomes a concealed card.
Questions
My shell can’t find justcopy.
Add ~/.local/bin to your PATH: echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc, then open a new terminal.
Does it need the AI switch on?
Yes. It uses the same server. Turn on “Let AI assistants read my clipboard” in Settings → AI. Adding cards also needs “Let tools add cards”.
Can a script read the cards I keep private?
The same privacy filters apply to every command. They withhold concealed cards, cards from excluded apps, and content detected as a likely key or token.