cargo-billing Skill for Claude Code: Cargo Credits, Usage and Invoices

Lets Claude show what Cargo is costing you: remaining credits, usage by workflow or connector, subscription state, invoices and the card on file.

Installs: 10.5K; on skills.sh
Stars: 21; on GitHub
Files: 4; besides SKILL.md
Updated: Oct 2026; last repo commit

Claude uses cargo-ai billing commands to read your credit balance, usage metrics grouped by workflow, connector or agent, the subscription, invoices and the card on file. It also estimates what a batch will cost before you run it, and can add or replace the workspace card.

SKILL.md says a new account starts with 100 free credits and no card, and that the commands need a token with admin access. It needs the Cargo CLI and a Cargo sign-in. Pinning spend to specific nodes belongs to cargo-diagnostics.

Good for

Admins tracking credit spend against a budget
RevOps leads asking why a bill is high
Owners who need to add or replace the workspace card

Install cargo-billing

Claude Code

Copy this prompt.

Install the cargo-billing skill in Claude Code. Run this command:

/plugin marketplace add getcargohq/cargo-skills
/plugin install cargo@cargo-skills

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Every Cargo skill drives the cargo-ai CLI, so install it and sign in first. A new account starts with 100 free credits and no card (README). Pick one channel, not two: the plugin and skills add both register the skills, so using both duplicates them. The whole bundle is the route the README documents; this skill's own files point to files in sibling skills such as ../cargo/references/prerequisites.md. The plugin needs Claude Code 2.1.154 or newer and adds hooks and two subagents; see the safety section.

From the project README. Source.

What's in the skill

When it loads

Understand what Cargo is costing — remaining credits, usage broken down by workflow, connector, or agent, subscription state, and invoice history. Triggers: "how many credits do I have left", "what did that cost", "why is my bill so high", "am I about to run out", "will this fit in our budget", "show me my invoices", "how much have I spent this month", "what plan am I on", "what do I get for free", "how many free credits", "can I afford this run", "add a card", "update my payment method", "why was my card declined". Needs a token with admin access. Skip when: attributing spend to specific nodes or cutting a play cost — use cargo-diagnostics.

Sections in SKILL.md

Bootstrap
Discover resources first
Quick reference
Estimating cost before running a batch
Usage metrics
The usage units
The execution charge
Subscription and credits
The free tier
Adding a card
Help

Key facts

Author: Cargo (frontmatter author: getcargo), in the vendor's own repo
License: MIT (LICENSE, README badge and plugin.json agree)
Version: 2.1.3
Installs on skills.sh: 10,527 (Nov 2, 2026)
GitHub stars: 21 (Nov 2, 2026)
Last commit: Oct 31, 2026
What installs: 5 files including SKILL.md: 3 reference and example files and skill-metadata.json
Needs: The cargo-ai CLI (npm) and a Cargo sign-in; a new account starts with 100 free credits
Cargo CLI license: UNLICENSED on npm; the skills bundle itself is MIT
Bundle size: README and plugin manifests say 19 skills, the skills.sh badge says 18, and the repo has 20 skill folders including a redirect stub
Works in: Claude Code, Codex, Cursor, Windsurf, GitHub Copilot, Hermes Agent and other skills.sh agents

What it includes

Returns credit usage between two dates, optionally grouped by workflow or connector.
Runs code · usage get-metrics
Checks the balance and prices a batch before you trigger it.
Runs code · Estimate before a batch
Shows plan, credits used and available, and period dates.
Runs code · subscription get
Lists invoices; amounts come back in cents.
Runs code · subscription get-invoices
Shows the card on file.
Runs code · subscription get-credit-card
Sets the workspace card from flags, stdin JSON or a hosted Stripe form.
Runs code · update-payment-method
Returns a Stripe portal URL for self-service billing.
Runs code · create-portal-session
What 100 free credits buy: about 500 sourced leads or 1,000 email checks.
Free-tier anchors

From the official docs

Permissions

Medium risk

It can read invoices and replace the card Cargo charges. Use the hosted card form and an admin token only for the session that needs it.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It can replace the card Cargo charges
update-payment-method sets the one card for the workspace. Use --card-stdin or the hosted form, and never paste a card number into chat. github.com
Card flags are visible in shell history
SKILL.md says anything passed as a flag is visible in shell history and to processes that can read the process list, so it prefers stdin. github.com
Claude runs the cargo-ai CLI as you
The skill drives the cargo-ai CLI. Sign-in is saved to ~/.config/cargo-ai/credentials.json, and the docs say to confirm the workspace with cargo-ai whoami before any write. github.com
The plugin route adds hooks that run shell commands
The plugin wires a PreToolUse hook on Bash that auto-approves safe cargo-ai calls, and a SessionStart hook that runs npm install -g @cargo-ai/cli at the pinned version. Login, token creation, report creation, project deploy and any remove or delete still prompt. github.com
The plugin sends a session summary to your Cargo workspace
The SessionEnd hook passes the last 60,000 bytes of the transcript to claude -p to write a title and summary, then stores them in your Cargo workspace session record. Use the skills CLI route if you do not want that. github.com
Billing data needs an admin token
Usage, subscription and invoice commands need admin access. Do not hand an admin token to a session that only needs a balance. github.com
The plugin also adds two subagents
cargo-execution-planner and cargo-list-builder run on the haiku model with Read, Grep, Glob and Bash tools. The planner is described as read-only and the list builder as executing only pre-approved slices. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Talks to	api.getcargo.io (Cargo API). registry.npmjs.org (CLI install). app.getcargo.io (token creation)
Sign-in and keys	Sign-in by emailed code, browser (OAuth) or an API token. Browser and email sign-in save a session to ~/.config/cargo-ai/credentials.json; API tokens are workspace-scoped and the README says to store them in a secrets manager.
Scopes	Reads billing data; can replace the workspace card Needs a token with admin access Cargo workspace sign-in (saved in ~/.config/cargo-ai/credentials.json)

Questions

What does cargo-billing do?

It lets Claude answer money questions about Cargo: how many credits are left, what a run cost, where usage went, which plan you are on, and what your invoices say.

How many free credits do I get?

SKILL.md says a new account starts with 100 free credits and no card on file. As anchors it gives about 500 leads sourced at 0.2 each, or about 1,000 email checks at 0.1 each.

Can it change my payment card?

Yes. update-payment-method sets the workspace's single card. SKILL.md prefers --card-stdin or the no-argument hosted form over card flags, because flags show up in shell history and the process list. It says card details go straight to Stripe and never reach the Cargo API.

Do I need admin access?

Yes. SKILL.md says all of cargo-billing needs a token with admin access.

Billing or cargo-diagnostics?

Use cargo-billing for balances, plans and invoices. SKILL.md sends attributing spend to specific nodes or cutting a play's cost to cargo-diagnostics.

How do I install it?

Use the install box above. Install the whole Cargo bundle, then the Cargo CLI and sign in. The README says to pick one channel, plugin or skills add, not both.

Is it official?

Yes. It sits in Cargo's own repo (getcargohq/cargo-skills), the LICENSE names Cargo as the copyright holder and the plugin manifest lists Cargo as the author.

Does it work in the Claude app, Codex or Cursor?

The README names Claude Code, Codex, Cursor, Windsurf, GitHub Copilot and Hermes Agent. For Claude Desktop it documents a Claude Cowork plugin route with network egress turned on. The skill drives a local CLI, so there is no plain Claude app skill upload here.

Is it safe to use?

It can read invoices and change the card that Cargo charges. SKILL.md tells Claude never to invent card details and not to reuse a number from elsewhere in the conversation, and card updates are limited to 10 per hour per workspace. Our advice: use the hosted form so card numbers never pass through chat.

Information

updated Nov 2, 2026

Repository: getcargohq/cargo-skills
Folder: cargo-billing

getcargohq/cargo-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 7

cargo-skills README · github.com
cargo prerequisites.md · github.com
cargo-billing SKILL.md · github.com
cargo-skills LICENSE · github.com
cargo-skills plugin.json · github.com
session-end.sh · github.com
session-start.sh · github.com