Skip to main content
The CLI, the CDK, and Cargo Skills all ship in a single package and share the same login. Set this up once and every layer works.

​
Install

npm install -g @cargo-ai/cli
Without a global install, prefix every command with npx @cargo-ai/cli instead of cargo-ai.

​
Log in

Log in with your API token (find it under Settings > API in your Cargo workspace): 
cargo-ai login --token <your-api-token>
To target a specific workspace: 
cargo-ai login --token <your-api-token> --workspace-uuid <your-workspace-uuid>
API token values are shown only once at creation time. Store them immediately in a secrets manager (GitHub Secrets, AWS Secrets Manager, 1Password, etc.).

​
Verify

cargo-ai whoami
# → {"user":{"uuid":"...","email":"you@example.com"},"workspace":{"uuid":"...","name":"My Workspace"}}
In CI or Claude Code, persist your token as an environment variable so it’s available from any working directory: export CARGO_API_TOKEN=<your-api-token> (add it to ~/.zshrc or ~/.bashrc).

​
Next steps

CLI

Command reference, UUID flows, filter syntax, async patterns, and gotchas.

CDK

Define your workspace in code and deploy it declaratively.

Skills

Install Skills so your AI agent drives the CLI for you.