Skip to main content
Everything you need to run Cargo outside the browser ships in a single npm package, @cargo-ai/cli. It exposes three layers that share the same authentication, the same JSON responses, and the same platform surface:

CLI

Imperative, one-off commands. Run tools, trigger plays, query the warehouse, chat with agents — from a terminal, a script, or CI.

CDK

Declarative infrastructure-as-code. Define a whole workspace in TypeScript and reconcile it with plan / deploy.

Skills

Structured prompt packages that teach Claude Code, Cursor, Codex and other agents how to drive the CLI in natural language.
They aren’t separate products — the CDK is the cargo-ai cdk subcommand, and Skills are prompt packages layered on top of the same CLI. Install once, authenticate once, then pick the layer that fits the task.

​
Which should I use?

Reach for the…When you want to…
CLIRun one-off or scripted operations — a single enrichment, a batch play, a SQL query, an agent chat — with full control over each command.
CDKManage a whole workspace as versioned, diffable code with state tracking and drift detection (cargo.state.json, plan, deploy).
SkillsLet an AI agent (Claude Code, Cursor, Codex, …) figure out the commands for you from a plain-English request.
A rule of thumb:
  • Imperative, ad hoc, or CI step → CLI
  • Declarative, reproducible workspace → CDK
  • Natural-language, agent-driven → Skills
All three can coexist in the same project. It’s common to define core resources with the CDK, run day-to-day operations with the CLI, and hand repetitive tasks to an agent through Skills.

​
Get started

Install & authenticate

Install @cargo-ai/cli, log in with your API token, and verify your workspace. Shared by all three layers.

API Reference

Prefer raw HTTP? Call the Cargo REST API directly.