View as Markdown Open in ChatGPT Open in Claude

CLI

@justclaw-it/cli connects the coding agents on your machine to JustClaw-It in one command. It installs a justclaw-it command, needs Node.js 18.17 or newer, and has no runtime dependencies. It is MIT-licensed; the npm package contains its full source.

The 0.1.0 release is rolling out on npm. If npx stops with justclaw-it: not found, set your agent up by hand from the client guides; it is one command or one config entry.

init

npx @justclaw-it/cli init

or, without npm on your PATH (the script only runs the same CLI):

curl -fsSL https://justclaw.it.com/install | sh

Paste your API key, or press Enter to open /signup (free, no card).
The CLI checks the key with a live tools/list call.
It finds the agents on your machine and adds the justclaw-it MCP server to each. Every file it edits is backed up first as <file>.justclaw-it-bak-<timestamp>.
It installs the three agent skills into Claude Code, OpenClaw and Hermes.

Supported clients and their ids: claude-code, claude-desktop, cursor, windsurf, codex, openclaw, hermes. VS Code is set up by hand (guide).

doctor

npx @justclaw-it/cli doctor
npx @justclaw-it/cli doctor --search "jwt auth middleware express"

Tests the connection, shows your plan and usage, and checks each agent's config. --search runs one real search (free).

uninstall

npx @justclaw-it/cli uninstall

Removes the justclaw-it entries and the skills that init added, and nothing else.

Options

option	what it does
`--key <key>`	API key. Default: `$JUSTCLAW_IT_API_KEY`, then the saved key, then a prompt.
`--clients <list>`	Only these clients, comma-separated, for example `--clients claude-code,cursor`.
`--yes`, `-y`	Don't ask; configure every detected client.
`--no-skills`	Don't install the agent skills.
`--search "<query>"`	With `doctor`: run one real search.
`--url <url>`	MCP endpoint (default `https://justclaw.it.com/mcp`).

Non-interactive, for scripts and CI:

JUSTCLAW_IT_API_KEY=<YOUR_API_KEY> npx @justclaw-it/cli init --yes --clients claude-code

Where your key goes

The CLI writes the key only into each agent's own config file (as the justclaw-it MCP entry), or the agent's env file for Hermes, plus ~/.config/justclaw-it/config.json (mode 600) so doctor can use it. It sends the key nowhere except https://justclaw.it.com and never prints it in full. Lost or leaked key: regenerate it at /account and run init again.

Upgrading from a pre-release

init cleans up after pre-release installs: old MCP entries and skill folders from earlier names are removed and replaced by justclaw-it and justclaw-it-*, and a key saved by a pre-release is moved to ~/.config/justclaw-it/.