Your Claude Code stats, in one card.
One command parses your Claude Code sessions and generates an embeddable SVG stats card. Embed it in your README, portfolio, or dotfiles.
npx @jjaimealeman/shipcard summaryOr install globally:
npm install -g @jjaimealeman/shipcard
shipcard summary # terminal overview
shipcard costs # cost breakdown by project and model
shipcard card --local # generate SVG card
shipcard login # authenticate with GitHub
shipcard sync --confirm # push stats to shipcard.dev
shipcard slug create # custom card URLs (PRO)After syncing, add this to your README:
With a theme:
9 curated themes: catppuccin, dracula, tokyo-night, nord, gruvbox, solarized-dark, solarized-light, one-dark, monokai
Customize at shipcard.dev/configure or pass query params directly:
?theme=dracula&layout=hero&style=branded
Ask Claude about your coding stats from inside Claude Code. Paste this into any Claude Code conversation:
Add a ShipCard MCP server to my ~/.claude.json file under the mcpServers key:
name: "shipcard"
command: "npx"
args: ["-y", "-p", "@jjaimealeman/shipcard", "shipcard-mcp"]
After restarting Claude Code, you'll have access to shipcard:summary, shipcard:costs, and shipcard:card tools in any conversation.
Example conversations:
❯ how many sessions have I had this month?
● 226 sessions this month, ~$1,977.81 in estimated cost.
That's a busy March.
❯ compare march to february?
● ┌──────────┬────────────┬────────────┐
│ │ February │ March │
├──────────┼────────────┼────────────┤
│ Sessions │ 264 │ 226 │
├──────────┼────────────┼────────────┤
│ Cost │ ~$1,519.69 │ ~$1,977.81 │
└──────────┴────────────┴────────────┘
Fewer sessions in March but $458 more expensive —
heavier models (Opus) this month.
| Command | What it does |
|---|---|
shipcard summary |
Sessions, tokens, cost, models, tool call counts |
shipcard costs |
Cost breakdown by project and model |
shipcard card |
Generate SVG card (--local) or preview JSON |
shipcard login |
Authenticate via GitHub device flow |
shipcard sync |
Push stats to cloud, get embeddable URL |
shipcard slug |
Manage custom card URL slugs (PRO) |
See USAGE.md for full flag reference.
Free:
- Local CLI + MCP server
- 9 curated themes, 3 layouts, 3 styles
- Cloud sync with embeddable card URL
- Analytics dashboard with 9 chart panels
- Community leaderboard
PRO ($2/mo):
- Custom colors (BYOT — bring your own theme)
- Custom URL slugs (
/u/you/dark-minimal) - PRO badge on card
- AI coding insights (peak hours, cost trends, streaks)
- Priority cache refresh
ShipCard parses Claude Code JSONL files from approximately January 2026 onward. Earlier sessions used a different schema that lacks the fields ShipCard needs. The SQLite bridge (v3.0) will preserve your data permanently going forward — no more data loss from format changes.
v2.1 — Polish & Launch
- Landing page animations (Vue + Cloudflare Pages)
- Hero video section (Remotion)
- Additional theme packs
- Card badge customization
v3.0 — SQLite Bridge
- Local SQLite database (
~/.shipcard/stats.db) replaces raw JSONL parsing - Incremental ETL — only parse new sessions, not the full history
- Hook-driven sync (auto-update after each Claude Code session)
- Survives Anthropic JSONL format changes — old data safe forever
- 10x faster CLI and MCP responses
v4.0 — Teams & Enterprise
- Team dashboards with shared stats (
/t/:team/dashboard) - PostgreSQL option for persistent multi-month data
- Multi-agent support (Codex CLI, Gemini CLI, Kiro, OpenCode)
- Cost allocation and budget alerts
- Weekly email digest of AI insights
Future
- VS Code extension with inline stats
- GitHub Action for auto-sync on push
- Burn rate predictor (estimated cost remaining in billing window)
- Natural language date filtering (
--since yesterday)
- shipcard.dev — landing page
- shipcard.dev/community — leaderboard
- shipcard.dev/configure — card configurator
- USAGE.md — full CLI + MCP reference
MIT License · Built on Cloudflare · Made in El Paso