Skip to content

Getting Started

1. Install CLI

pip install cost-guard

2. Create Account

Visit https://app.costcut.dev/signup and sign up with email + password.

3. Generate API Key

  1. Log in to https://app.costcut.dev
  2. Go to Settings → API Keys
  3. Click "Create Key"
  4. Copy the key (starts with cg_live_)

4. Authenticate CLI

cost-guard auth set cg_live_<your_key_here>

Verify: 

cost-guard auth status

5. Push Sessions

Scan your Claude Code projects and upload session data:

cost-guard push

By default, uploads sessions from last 30 days. Customize with --since:

cost-guard push --since 7  # last 7 days

6. View Dashboard

Open https://app.costcut.dev/dashboard to see usage analytics.

Next Steps