CLI Reference

Auth & keys

intent login, logout, and the keys subcommand for bringing your own Anthropic API key.

intent login

intent login

Opens your browser to authenticate via device-flow login. Creates a pending authorization request, then polls for approval every 3 seconds for up to 10 minutes. On success, saves a token (plus API base and analytics keys) to ~/.intent/auth.json.

Fails immediately if you're already logged in. Times out after 10 minutes if never approved — just run it again.

intent logout

intent logout

Deletes ~/.intent/auth.json. Safe to run if you're already logged out.

intent keys

Manage your Anthropic API key — this unlocks AI-powered commands (complexity, research, import, implement --stub) on any plan via a bring-your-own-key (BYOK) model, instead of requiring the Builder plan.

intent keys set [key]

intent keys set                  # prompts for the key
intent keys set sk-ant-...       # pass it directly

Encrypts and stores the key server-side. Prints the masked key on success.

intent keys status

intent keys status

Shows whether a key is currently set, masked.

intent keys remove

intent keys remove

Deletes the stored key. AI features fall back to your plan's normal limits (or gate behind an upgrade prompt on Free).