Skip to content

Getting Started

1. Install CLI

pip install costcut

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

costcut auth set cg_live_<your_key_here>

Verify: 

costcut auth status

5. Push Sessions

Scan your Claude Code projects and upload session data:

costcut push

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

costcut push --since 7  # last 7 days

6. View Dashboard

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

Next Steps