copyprompt-cli

Community prompts from CopyPrompt, straight in your terminal. Zero dependencies, just Node 20+.

The package is copyprompt-cli; the command it installs is copyprompt.

Quick start (npx, no install)

npx copyprompt-cli login        # paste a key from copyprompt.dev/settings#api
npx copyprompt-cli search "product photography"
npx copyprompt-cli get <slug>   # every search result prints its slug
npx copyprompt-cli add <slug>

The API needs a key from an account with a confirmed e-mail (see login below), so login comes first.

Or install once and use the short command everywhere:

npm i -g copyprompt-cli
copyprompt search "product photography"

get copies the prompt straight to your clipboard (PowerShell's Set-Clipboard on Windows, with clip.exe as a fallback; pbcopy on macOS, wl-copy/xclip on Linux). With no clipboard utility available, the text goes to stdout, so you can pipe it: copyprompt get slug | other-command.

Commands

copyprompt get <slug> [--vars key=value ...]

Fetches the prompt and copies the final text. Templates with {{variables}} are interpolated on the spot:

copyprompt get <slug> --vars product="a running shoe" light_color=golden

Variables you left out are reported, never silently dropped.

copyprompt search <query> [-c category] [--github]

Lists up to 10 prompts with rating, copies and a ready-to-paste get command:

copyprompt search refactor -c code

--github (or -g) lists only repository-backed publications (plugins, scripts, skills hosted on GitHub).

Categories: image, video, text, code, agents, audio, design3d, productivity, chatbot, marketing, data, education, research, other.

copyprompt add <slug> [--dir <folder>]

Installs a skill into .claude/skills/<slug> (use --dir for another skills folder). It fetches the package, prints every file in full, and asks before writing anything. Answer y and only then does it touch your disk.

copyprompt add <slug>

There is no --yes, and there never will be. A skill is not a dependency that runs in a sandbox: it is a set of instructions your agent will follow, written by a stranger. A flag to skip the review would turn this into curl | sh - the first person would read the package and everyone after would copy the line with the flag already in it, quite possibly from a README written by the author of the package. The review is the whole point.

For the same reason it prints every file, not just the SKILL.md: a confirmation that hides part of what it authorizes is not a confirmation, and a payload would live in scripts/setup.sh, not in the file you were shown.

It refuses to install if the destination already exists, if any path in the package would land outside the destination folder, or if there is no terminal to review in (a pipe is not a yes).

copyprompt login

Stores your API key in ~/.copyprompt.json (owner-only permissions); sent as Authorization: Bearer on every command.

copyprompt login                            # asks for the key, hidden prompt
echo "$COPYPROMPT_KEY" | copyprompt login   # scripts and CI

copyprompt login <key> still works, but a key typed as an argument stays in your shell history and shows up in the process list while the command runs, and it stays there after you revoke the key. The two forms above leave no trace.

A key is required, not an upgrade: since 3 Sep 2026 the API has no anonymous path, and it has to come from an account with a confirmed e-mail. The rate limit is 600 req/h per key. The catalog stays fully readable on the website without any of this - what closed was machine consumption without an owner. Create yours at copyprompt.dev/settings#api.

copyprompt --version

Prints the installed version. copyprompt help lists every command.

Configuration

| Env | Default | What for | | -------------------- | ------------------------ | --------------------------------- | | COPYPROMPT_API_URL | https://copyprompt.dev | Point at another instance or your dev server (http://localhost:3322) |

Language

The CLI speaks English; the API is language-neutral and returns the text each author wrote. The website itself is bilingual: English at copyprompt.dev and Brazilian Portuguese at copyprompt.dev/pt.

Your AI can use it too

The same catalog is available over MCP; connect Claude, GPT or your own agent and let the AI search the prompts on its own.

copyprompt chat: your own agent, no third-party client

The CopyPrompt MCP server was never tied to Claude: it is JSON-RPC over HTTP. What was missing was a client: the program that holds the conversation, offers the tools to a model, runs what the model asks for and feeds the result back. chat is that client, and it lives here.

copyprompt chat -p claude      # ANTHROPIC_API_KEY
copyprompt chat -p kimi        # MOONSHOT_API_KEY
copyprompt chat -p glm         # ZAI_API_KEY
copyprompt chat -p gemini      # GEMINI_API_KEY
copyprompt chat -p ollama      # no key, talks to localhost:11434

Providers: openai, kimi, glm, deepseek, groq, claude, gemini, ollama, lmstudio. Override the model with COPYPROMPT_MODEL and the endpoint with COPYPROMPT_MODEL_BASE_URL; a new model does not need a new release of this CLI.

Piping works too, for a single question:

echo "find me a product photography prompt" | copyprompt chat -p ollama

Where the keys go

Two keys, and they never meet:

• your model key is read from the environment and goes straight to that provider; it is not stored, not logged, and never touches copyprompt.dev;
• your CopyPrompt key (~/.copyprompt.json, from copyprompt login) only ever goes to our MCP server.

That separation is the reason the agent lives in the CLI instead of on the website: on the website, your model key would have to reach our servers first.