Core

Push

Sync data to the dashboard

npx promptreports-cli push

Pushes token stats, session data, and provider costs to your PromptReports.ai dashboard with delta-push checkpoints.

push is the bridge between your local CLI and the web dashboard. It aggregates sessions, turns, aggregate metrics, and suggestions, then POSTs to the platform. Implements delta sync via a checkpoint file (.claude/.token-push-checkpoint.json) to only send new turns — never re-uploads data. Batches turns in 500-per-request chunks to stay within serverless body limits.

Prerequisites

PROMPTREPORTS_API_KEY environment variable set (get from Account > API Keys on the dashboard)
Claude Code sessions in ~/.claude/projects/

Flags & Options

Flag	Description	Default
--days N	Lookback period	7
--dry-run	Preview what would be sent without pushing	—
--quiet	Suppress output	—

Examples

Push last 7 days

npx promptreports-cli push

Default — syncs new turns since last push.

First push (force 30d)

npx promptreports-cli push --days 30

Send a month of history on first sync.

Preview only

npx promptreports-cli push --dry-run

See what would be sent without hitting the API.

Output

Push summary with session/turn/token/cost counts, delta info (X turns already synced, Y new), batch progress, and success confirmation.

  Push Summary
  Sessions: 5, Turns: 127, Tokens: 456.2K, Cost: $4.23
  Last push: 95 turns already synced
  New turns: 32 (95 already synced)

  Sending batch 1/1 (32 turns + aggregate)...
  ✓ Pushed: success (1 batch, 32 turns)

  Dashboard: https://www.promptreports.ai/swarm/dashboard

What it reads and writes

Reads

~/.claude/projects/**/*.jsonl
.env.local
.claude/.token-push-checkpoint.json (if exists)

Writes

.claude/.token-push-checkpoint.json (updated after successful push, trimmed to last 50k turn keys)

API calls

POST https://www.promptreports.ai/api/swarm/token-stats
Header: Authorization: Bearer {PROMPTREPORTS_API_KEY}
Timeout: 15s per batch

Free vs Pro usage

Free tier

Push up to 1,000 turns/week free
View your data on the web dashboard
Basic cost and efficiency scores

Pro tier

Upgrade

Unlimited push volume
Team aggregation (your whole engineering org in one view)
Real-time alerts on anomalies
Historical retention (90+ days)
API access to your pushed data

Pro tips

Set up a cron or git hook to push after every session
Checkpoint file prevents duplicate data even if you run push 100x
Use --dry-run the first time to see what gets sent

Free to try

Install the whole toolkit.

One command unlocks all 23 tools.

Start Free Back to all tools