Claude Session Dashboard CLI
A local dashboard over the .claude folder shows where Claude Code context goes and draws the chain of subagent calls over time.
- 77 ★ on the repository
- Last commit
Extended access
Why this level
- Reads logs of all your Claude Code sessions, which may contain paths, project names and code fragments.
Install
- Works in
Manual install
npx claude-session-dashboardThe panel opens at `http://localhost:3000`.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Reads logs of all your Claude Code sessions, which may contain paths, project names and code fragments.
This is third-party code. Review the repository files before installing.
What it does
Claude Session Dashboard is a web panel that reads your local Claude Code session logs in `~/.claude` and shows how workflows actually run. Start it with one command, `npx claude-session-dashboard`, and the panel opens at `localhost:3000`. The main view is a Gantt chart of delegation: which subagents ran, in what order, for how long and how many tokens each spent. Beside it sit a breakdown of the context window into input, output and cache reads and writes, a session list searchable by name, project and branch, a yearly usage heatmap, cost estimates per model and CSV and JSON export. Privacy mode hides project names, paths and usernames in screenshots.
Who it is for. Claude Code users with subagents and custom skills who want to see context spend and tune delegation.
Good fit when
- A session starts well but halfway through Claude repeats itself and you need to find where context bloated.
- You want to compare task cost across models and projects.
- You check which subagents a workflow really launched and how long each took.
- You need an analytics screenshot without project names and paths.
- Session data must be exported to CSV for a report.
Not a fit when
- You need a team-wide analytics panel: data comes only from the local `~/.claude`.
- You want to edit or clean session logs: the panel is read-only.
- You need a tool that interferes with the Claude Code process itself.
Example request
Run `npx claude-session-dashboard` and show the subagent chain in the latest session with token spend for each.Limitations
The panel reads only local JSONL logs in `~/.claude` and neither changes nor sends anything. By default it listens on `localhost` port 3000, the `--port` and `--host` options change the address, and exposing it on an external address is not advisable. Cost is an estimate: prices are configured per model and subscription tier, and settings live in `~/.claude-dashboard/settings.json`. Node.js is required to run through `npx`. Active session status is polled every three seconds.
How to disable. Stop the process with Ctrl+C. A global install is removed with `npm uninstall -g claude-session-dashboard`, and settings in `~/.claude-dashboard/settings.json` are deleted by hand.
FAQ
How do I start Claude Session Dashboard?
Run `npx claude-session-dashboard` and open `http://localhost:3000`. The `--port` option changes the port and `--host` sets the bind address, `localhost` by default.
What is the delegation chart?
A Gantt chart shows every subagent dispatch in a session in order, with duration and token usage. It can be zoomed for complex chains.
Does the panel send my data anywhere?
No. It runs on localhost, reads files only from `~/.claude` and does not modify Claude Code data. CSV and JSON export happens in the browser.
How is cost estimated?
From configurable API prices per model with subscription tiers: Free, Pro, Max 5x and Max 20x. The estimate is shown per session, agent and category.
How can I share a screenshot without personal data?
Turn on privacy mode: it consistently anonymizes project names, paths, branch names and usernames across all analytics views.
Discussion
No questions or reviews yet.
Related
CLI toolsA Claude Code plugin: a status line with context, 5-hour and 7-day limits, cost and usage of Codex, Gemini and z.ai
cc-lens
Claude Code Lens (cc-lens)
Local Claude Code analytics: a dashboard of sessions, tokens, cost and projects from your ~/.claude data, no cloud
A Claude Code panel for several projects: statuses, button decisions, Git, PR, CI and usage limits in one window.
Terminal manager for Claude Code sessions: live status per session, token cost by model and project, and summaries saved on exit.
An always-on-top widget and a CLI show Claude Code limits for 5 hours and 7 days, token burn and the cost of each turn.
claudetop shows session cost, cache hit rate, plan limit windows and overspend alerts in the Claude Code status line
README in short
The panel runs entirely on the user's machine, parses JSONL logs and refreshes active sessions by polling every three seconds. A separate projects tab sums sessions, messages, tokens and duration.