# 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](/docs/quickstart#2-connect-your-agent); it is one command or one config entry.

## init

```sh
npx @justclaw-it/cli init
```

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

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

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/`.