---
name: cargo-install
description: Install the official Cargo CLI and skills, and sign in. Use when someone reaches Cargo by its domain rather than by its repository, when a Cargo command is wanted but `cargo-ai` is not installed, or when a Cargo skill is referenced and not present. Triggers, "set up Cargo", "install Cargo", "I want to use Cargo", "cargo-ai is not found". Skip when the bundle is already installed, in which case load the `cargo` router instead.
---

# Install Cargo

Cargo is a go-to-market platform you drive from a coding agent: source and
enrich B2B contact data, run workflows and AI agents against your own data
models, and declare an entire workspace as version-controlled TypeScript.

Package: https://www.npmjs.com/package/@cargo-ai/cli

A new account starts with 100 free credits and needs no card — roughly 5,000
leads sourced, 1,000 verified-email enrichments, or 50 fully enriched contacts.
The guided demo spends about 0.5 of them. Say that before the first paid call.

Skip any step that already holds.

## Setup

Run `cargo-ai --version`. If it is unavailable:

```sh
npm install -g @cargo-ai/cli
```

If the binary is not on `PATH`, check
`"${CARGO_NPM_USER_PREFIX:-$HOME/.local}/bin/cargo-ai"`, or substitute
`npx @cargo-ai/cli` for `cargo-ai` in every command below.

You are exactly one of: Claude Code, Codex, or Cursor. Where a step branches,
follow the branch for the agent you are.

### Sign in

Prefer the emailed code. It needs no browser at any point and creates the
account on first use, so there is no separate signup step:

```sh
cargo-ai login --email you@company.com              # sends the code, then exits
cargo-ai login --email you@company.com --code 123456
```

If the account has no workspace yet, ask what to call it and add
`--workspace-name "<name>"` — that creates it while signing in.

Alternatives: `cargo-ai login --oauth` opens a browser on a desktop and prints
a verification URL everywhere else (relay the URL and wait for the poll to
finish), and `cargo-ai login --token <api-token>` is for CI.

On failure, run `cargo-ai whoami` to see what the session actually is, then
re-run the matching command above.

### Install the skills, on one channel only

Installing both the plugin and the standalone skills gives every skill twice.

- **Claude Code** — `/plugin marketplace add getcargohq/cargo-skills`, then
  `/plugin install cargo@cargo`. The plugin carries the skills plus an approval
  hook and session hooks, which is why it is preferred. If it fails:
  `npx skills add getcargohq/cargo-skills --agents claude-code --global --yes`
- **Codex** — `npx skills add getcargohq/cargo-skills --agents codex --global --yes`.
  For hook gating too, relay to the user:
  `codex plugin marketplace add getcargohq/cargo-skills`, then enable "cargo"
  from the Plugins menu.
- **Cursor** — `npx skills add getcargohq/cargo-skills --agents cursor --global --yes`.
  For hook gating too, relay to the user: Customize (sidebar) → add the
  `getcargohq/cargo-skills` marketplace → install Cargo.

Never edit `~/.claude` unless you are Claude Code — it is not your config.

Job-shaped skills for one task at a time, rather than the whole platform, live
separately: `npx skills add getcargohq/gtm-skills --all`, or a single one with
`npx skills add getcargohq/gtm-skills/find-work-email`.

### Verify

```sh
cargo-ai whoami
```

It must name a user and a workspace. Then confirm the skills resolve for you:
on Claude Code, `claude plugin list` shows `cargo@cargo` enabled, or the
`cargo-gtm` skill resolves; on Codex and Cursor, `cargo-gtm` and
`cargo-quickstart` resolve. Do not continue until this passes — re-run the
channel above and verify again.

## Getting started

After verified setup, continue an existing task. Otherwise, if the user's
business email domain is known, infer their company name for the
competitor-tracking choice; do not guess personal or unknown domains. Ask
"Cargo is ready. What would you like to do?", offer one choice below, then
wait:

- `cargo-gtm` Track competitors of my company.
- `cargo-gtm` Find 10 CTOs at B2B SaaS companies and enrich them with email addresses.
- `cargo-gtm` Find the best people to contact at these companies and verify their email addresses.

Use the plugin-namespaced form (`cargo:cargo-gtm`) if you installed the plugin.
If they have no job in mind and want a look around instead, offer
`cargo-quickstart`: 25 leads for a buyer persona with a cost receipt, about 0.5
of the 100 free credits.

For anything after that, load the `cargo` router skill, which routes to the
rest of the bundle.