Installs claude-session-dashboard — a local analytics dashboard for Claude Code sessions.
claude-dashboardcommand to launch the web UI- Session browsing with full-text search and filtering
- Token usage breakdown, cost estimates, and activity heatmaps
- Tool call timeline visualization
- Per-project aggregated analytics
- Settings persisted across container rebuilds via symlink to
/workspaces/.claude-dashboard/
| Option | Default | Description |
|---|---|---|
version |
latest |
npm package version (latest, 1.0.0, or none to skip) |
port |
7847 |
Default port for the dashboard server |
shells |
both |
Shell configs to add alias to (bash, zsh, both) |
username |
automatic |
Container user to install for |
# Start the dashboard (default port 7847)
claude-dashboard
# Start on a custom port
claude-dashboard -p 8080
# Show help
claude-dashboard --helpThe dashboard reads session data from ~/.claude/projects/.
Dashboard settings and cache are stored at ~/.claude-dashboard/. A poststart hook symlinks ~/.claude-dashboard → /workspaces/.claude-dashboard/, which is bind-mounted and survives rebuilds.