A dense TUI dashboard for your Anthropic Claude usage.
Single PC or many. Credentials never leave the machine that already holds them.
clawtop · 19:23:04 · hosts 2 (omen,pop-os) · plan team · window 7d fresh
──────────────────────────────────────────────────────────────────────────────────────
SESSION ██████████▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 31.0% · resets 29m
WEEK █▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 5.0% · resets 6d 8h
──────────────────────────────────────────────────────────────────────────────────────
TOP PROJECTS (last 7d) MODELS
rifeli 1.9M ████████████▒▒▒▒▒ opus-4-7 4.5M
omen 1.9M · pop-os 18.0k in 200.8k · out 4.3M · cache 100% · 32 sess
rifeli.dev 874.4k ███████▒▒▒▒▒▒▒▒▒▒
3 sessions
main-flora 731.2k ██████▒▒▒▒▒▒▒▒▒▒▒
2 sessions
nzomukongo 396.4k ███▒▒▒▒▒▒▒▒▒▒▒▒▒▒
6 sessions
jarvis-text-anls. 195.0k ██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
omen 151.2k · pop-os 43.8k
──────────────────────────────────────────────────────────────────────────────────────
HOSTS omen 3.5M·7p·20s·fresh pop-os 1.0M·8p·12s·fresh
──────────────────────────────────────────────────────────────────────────────────────
TOP SESSIONS
rifeli 1.2M opus-4-7 · 2h ago
rifeli 201k opus-4-7 · 14m ago
rifeli.dev 196k opus-4-7 · 3h ago
──────────────────────────────────────────────────────────────────────────────────────
24h ▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁█▄▁▁▁▁▁█ 1.6M · peak 507.1k
7d ▁▂▃▄▅█▃ 4.5M · peak 1.6M
t tabbed · f filter host · j/k scroll · g/G top/end · r reload · q quit
You run Claude on one machine and want a dashboard on that same machine.
# 1. Install binaries + systemd unit files.
curl -fsSL https://raw.githubusercontent.com/leonardorifeli/clawtop/main/install.sh | sh
# 2. Verify everything is wired correctly.
clawtopd doctor
# OK credentials ~/.claude/.credentials.json subscription=max
# OK anthropic api.anthropic.com session=12.1% week=4.3%
# OK destination local:~/.local/share/clawtop writable
# 3. Enable the daemon.
systemctl --user daemon-reload
systemctl --user enable --now clawtopd-local
# 4. Open the dashboard.
clawtop --dir=~/.local/share/clawtopThat's it. The daemon writes ~/.local/share/clawtop/<machine>.json once
a minute; the TUI re-reads every second.
You run Claude on several machines (laptop, desktop, work box) and want one dashboard that merges them, displayed on a homelab box, a Pi, an old NUC, or any always-on machine you can SSH into. The OAuth credentials stay on each Claude machine; only the derived JSON travels.
# --- On the viewer host (once) ---
sudo install -d -o $USER -g $USER /var/lib/clawtop
curl -fsSL https://raw.githubusercontent.com/leonardorifeli/clawtop/main/install.sh | sh -s -- viewer
systemctl --user daemon-reload
systemctl --user enable --now clawtop # launches tmux session
sudo loginctl enable-linger $USER # survives logout
# --- On each machine that runs Claude ---
curl -fsSL https://raw.githubusercontent.com/leonardorifeli/clawtop/main/install.sh | sh -s -- daemon
# Edit the unit to set --host=<your-viewer-ssh-alias>
${EDITOR:-vi} ~/.config/systemd/user/clawtopd-remote.service
clawtopd doctor --host=<your-viewer-alias> # 4 OKs expected
systemctl --user daemon-reload
systemctl --user enable --now clawtopd-remote
# --- Look at it from anywhere ---
ssh <viewer-host>
tmux attach -t clawtopThe full multi-PC walkthrough (with SSH setup, troubleshooting, the
common gotchas around SSH alias users and copy-pasted long URLs) is in
deploy/INSTALL.md.
Six tabs, or one dense dashboard view (default when terminal is ≥80×18):
- Limits — 5h and 7d rate-limit windows with reset countdowns.
- Projects — which working directories ate your token budget over the chosen window; per-host attribution when two or more machines contributed to the same project; session count per project.
- Models — Opus vs Sonnet vs Haiku split, input/output/cache columns, cache hit rate, distinct session count per model.
- Hosts — per-machine totals: tokens contributed, distinct projects, distinct sessions, freshness.
- Sessions — top 10 most expensive conversations in the window, with project, model, duration, last-seen.
- Hourly — 24h sparkline plus 7d daily breakdown.
Press f to filter to a single host (cycles through all → omen → pop-os
→ all). Or start with clawtop --machine=omen to lock to one machine.
clawtop is one of several open-source tools that read your local Claude transcripts. Pick the shape that matches your use case:
| Tool | Shape | Best when |
|---|---|---|
ccusage |
On-demand CLI, prints tables | You want a fast snapshot from the shell |
Claude-Code-Usage-Monitor |
Always-on terminal monitor with burn-rate predictions | You want ML projections on a single host |
ccflare |
Browser dashboard | You want graphs you can pan and zoom |
Clawdmeter |
ESP32 hardware display | You want a physical Clawd on your desk |
clawtop |
Dense TUI, single PC or multi-host aware, displays on any always-on screen | You run Claude on more than one machine, want one place to look, and don't want to copy OAuth credentials around |
If you only run Claude on a single laptop and just want a quick table,
ccusage is probably what you want. clawtop earns its keep when you
have several boxes (work laptop + personal desktop + dev VM + homelab)
and want a unified, always-on view.
Single PC — the daemon writes a local JSON, the TUI reads it:
┌─ your PC ──────────────────────────────────────────┐
│ ~/.claude/.credentials ─▶ clawtopd ─▶ ~/.local/share/clawtop/<machine>.json ─▶ clawtop
│ │
│ ▼
│ api.anthropic.com (1 Haiku token / minute)
└─────────────────────────────────────────────────────┘
Multi PC — each daemon pushes its own JSON to a chosen viewer host:
┌──────────────┐ ┌──────────────────┐
│ laptop │──clawtopd──┐ │ viewer host │
│ │ │ │ │
│ ~/.claude/ │ │ │ /var/lib/ │
│ .credentials │ │ ssh push │ clawtop/ │
└──────────────┘ ├────atomic──▶│ laptop.json │
│ │ omen.json │
┌──────────────┐ │ │ workpc.json │
│ omen │──clawtopd──┤ │ │ │
└──────────────┘ │ │ ▼ │
│ │ clawtop (TUI) │
┌──────────────┐ │ │ inside tmux │
│ workpc │──clawtopd──┘ └──────────────────┘
└──────────────┘
│
│ HTTPS (1 Haiku token / minute / machine)
▼
api.anthropic.com
The daemon polls Anthropic every 60s with max_tokens: 1 to read the
anthropic-ratelimit-unified-* response headers, and walks
~/.claude/projects/**/*.jsonl to aggregate per-project, per-model,
hourly, and daily token usage from your local transcripts. The merger
on the viewer side keeps account-scoped fields from the freshest report
and sums everything else element-wise.
clawtopd runs as a systemd --user service, so it inherits the same
file permissions as your interactive shell. It reads
~/.claude/.credentials.json like any other file, then talks to
Anthropic from the same host. The viewer — whether on the same PC or on
a remote box — only sees the derived JSON (rate-limit percentages,
token counts, session metadata). If the viewer host is compromised, the
attacker gets numbers, not the OAuth token.
clawtopd run (default subcommand):
| flag | default | what |
|---|---|---|
--host |
localhost |
localhost writes locally; anything else is treated as an ssh_config alias and pushed via SSH |
--dir |
~/.local/share/clawtop (local) or /var/lib/clawtop (ssh) |
directory for the per-machine status JSON |
--creds |
~/.claude/.credentials.json |
Claude OAuth credentials file |
--machine |
hostname | stable identifier, becomes <machine>.json |
--projects |
~/.claude/projects |
transcripts root (honors $CLAUDE_CONFIG_DIR) |
--window |
168h (7d) |
aggregation lookback |
--interval |
60s |
poll cadence |
--once |
false |
probe once and exit (smoke test) |
--local-only |
false |
print to stdout instead of writing |
--skip-probe |
false |
skip the Anthropic call, aggregate transcripts only |
clawtopd doctor accepts the same flags and runs four preflight checks:
credentials are readable, Anthropic responds, SSH alias is reachable
(if remote), destination is writable.
clawtop (viewer):
| flag | default | what |
|---|---|---|
--dir |
/var/lib/clawtop |
directory of per-machine status JSON files |
--machine |
"" (all merged) | show only the named machine's data |
Key bindings: tab/shift-tab or ←/→ cycle tabs, 1–6 jump
directly, t toggle dashboard/tabbed, f cycle host filter,
j/k/g/G/PgUp/PgDn scroll the project list, r reload, q
quit.
{
"schema": 3,
"machine": "omen",
"ts": 1716688320,
"session": { "pct": 31.0, "reset_at": 1716700000 },
"week": { "pct": 5.0, "reset_at": 1717100000 },
"limit": "allowed",
"subscription": "team",
"window": "7d",
"sessions": 20,
"by_project": [
{ "name": "rifeli", "path": "/home/rifeli/projects/personal/rifeli",
"in": 12345, "out": 1900000, "cache_read": 45e6, "cache_create": 1.4e6,
"sessions": 5 }
],
"by_model": [
{ "model": "claude-opus-4-7",
"in": 200800, "out": 4300000, "cache_read": 462500000, "cache_create": 14600000,
"sessions": 32 }
],
"hourly_24h": [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 107835, 7436, 0, 0, 0, 0, 0, 0, 178055],
"daily_7d": [120000, 250000, 80000, 400000, 600000, 1100000, 1300000],
"top_sessions": [
{ "id": "abc-...", "project": "rifeli", "model": "claude-opus-4-7",
"in": 186931, "out": 966588, "started_at": 1716680000, "last_at": 1716688000 }
]
}Tiny payload (~1–5 KB per machine), self-describing, forward-compatible. Old viewers ignore unknown fields; new viewers default-zero missing ones.
clawtop/
├── cmd/
│ ├── clawtop/ # TUI binary
│ └── clawtopd/ # daemon binary + doctor subcommand
├── external/ # adapters to the outside world
│ ├── anthropic/ # API client (creds + probe)
│ └── push/ # Pusher interface + Local + SSH implementations
├── internal/
│ ├── domain/ # on-the-wire entities
│ └── service/ # business logic
│ ├── collector/ # parse transcripts → aggregate
│ └── merger/ # merge N per-machine payloads
└── deploy/ # systemd units + INSTALL.md
One Haiku call with max_tokens: 1 per minute per daemon. On a Max or
Team plan this is billed against the same subscription quota you're
watching and shows up in the very dashboard you're looking at. Three
machines combined add up to a single-digit number of cents per month.
PRs welcome. The whole thing is around 1000 lines of Go. See
CHANGELOG for
the release-by-release feature list.
This project would not exist without
Clawdmeter by
Hermann Bjorgvin, which is where I
learned the Anthropic OAuth surface exposes the unified rate-limit
headers, and ccusage by
ryoppippi, which set the bar for what
transcript-derived analysis should look like.
MIT — see LICENSE.