# 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.
> **Not published yet.** The CLI is not on npm yet, so the `npx @justclaw-it/cli` commands on this page do not work today. Set your agent up from the [client guides](/docs/quickstart#2-connect-your-agent) (one command or one config entry), or run the CLI from the public repo as shown below.
**Run it from the public repo today.** The CLI source is public at [github.com/justclaw-it/justclaw-it-mcp](https://github.com/justclaw-it/justclaw-it-mcp) (MIT). With Node.js 18.17 or newer:
```sh
git clone https://github.com/justclaw-it/justclaw-it-mcp
node justclaw-it-mcp/cli/bin/justclaw-it.js init
```
It runs the same `init`, `doctor` and `uninstall` commands described below; read `cli/bin/justclaw-it.js` first if you want to see exactly which files it edits.
## init
```sh
npx @justclaw-it/cli init
```
1. Paste your API key, or press Enter to open [/signup](/signup) (free, no card).
2. The CLI checks the key with a live `tools/list` call.
3. 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>`.
4. It installs the three [agent skills](/docs/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](/docs/clients/vscode)).
## doctor
```sh
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
```sh
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:
```sh
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](/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/`.