Live session dashboard
Shows active Claude Code sessions in a single dashboard, including project, status, model, token totals, uptime, and recent activity.
claude-code-session-tracker
claude-code-session-tracker is a local, open-source dashboard for tracking Claude Code sessions, usage limits, token history, and context-window details in your browser.
Claude Code usage monitoring in a local dashboard
claude-code-session-tracker is a local, open-source dashboard for monitoring Claude Code sessions and usage. It brings active sessions, project and model details, token totals, and both five-hour and seven-day usage windows into one browser interface.
The tracker also provides detailed session analysis and historical reporting. Users can inspect context-window composition, review token activity by day or hour, compare projects and models, export a report, and optionally receive desktop notifications as a usage window approaches its limit. The site describes the application as read-only, loopback-bound, and designed to run without dependencies beyond Node 20 or newer.
Core features
Usage-limit monitoring
Displays Anthropic's five-hour session and seven-day weekly usage readings, reset times, percentage used, and an estimate of when a limit will be reached at the current pace.
Session inspection
Opens detailed session views with input, output, total and cache token counts, context-window usage, static context sources, prompts, and a resume command.
Token history and reports
Provides token history by local day, half-hour period, project, and model, with range filters, charts, a year view, export, and shareable imagery.
Desktop alerts
Can notify users before a session or weekly window is expected to run past its limit. Notifications are optional, off by default, and configurable by window.
Usage findings
Highlights heavier usage patterns such as long sessions and standing context, helping users identify where tokens are being spent.
Who it is useful for
Managing concurrent Claude Code work
Watch multiple active projects from one page, see which sessions are busy or waiting for input, and reopen a session when work needs attention.
Avoiding usage-limit surprises
Compare current consumption with the five-hour and seven-day windows to decide whether to continue a task, change pace, or wait for a reset.
Reducing context overhead
Open a session's context breakdown to find large CLAUDE.md files, skills, tools, agents, MCP instructions, or conversation history that contribute to the window.
Reviewing usage over time
Use day, hour, project, and model views to understand where tokens accumulate over a month or longer, then export the resulting report for further reference.
Monitoring in the background
Enable desktop alerts when working in another application so a usage window nearing its limit is surfaced before the limit is reached.
Pros and Cons
Pros
- Combines live sessions, usage limits, token history, and session details in one interface.
- Shows both billed token activity and cache reads, with context-window breakdowns that explain what contributes to a session.
- Offers local day, hour, project, model, and year-level history with export and share options.
- Runs locally, is read-only according to the site, and is MIT licensed.
- Supports macOS, Linux, and Windows with a browser-based local interface.
Cons
- The product is designed around local, single-machine monitoring; the available evidence does not establish team dashboards, shared accounts, or hosted access.
- Node 20 or newer is required, and alerts must be enabled manually because they are off by default.
- The available page content does not document integrations beyond its Claude Code tracking workflow.
FAQ
How do I start claude-code-session-tracker?
Run `npx claude-code-session-tracker`, then open the printed local address, `http://127.0.0.1:3099`, in a browser.
What does the tracker display?
The dashboard shows active Claude Code sessions, session and weekly usage windows, token details, session context, and resume commands. A separate History page provides token views and export options.
Can it alert me before a usage limit?
Yes. Desktop notifications can be enabled in Settings for the five-hour session limit and seven-day weekly limit. Notifications are off by default and are limited to one per configured interval.
Does the tracker send data to a remote service?
The product is presented as local and loopback-bound. The page states that it is read-only and that data does not leave the machine.
What are the stated platform and licensing requirements?
The site lists Node 20 or newer and support for macOS, Linux, and Windows. It is MIT licensed and described as open source.
Quick Facts
- Category
- Developer tool
- Primary workflow
- Claude Code session and token monitoring
- Runtime
- Node 20 or newer
- Platforms
- macOS, Linux, and Windows
- License
- MIT licensed; open source
- Local address
- http://127.0.0.1:3099
claude-code-session-tracker Alternatives
ByteAsk
ByteAsk is a terminal-first AI coding agent for C and C++ that edits repos and verifies changes with compilers, debuggers, sanitizers, and tests.
Epherem
Epherem scans web apps built with Lovable, Bolt, v0, Replit, Cursor, and Claude Code for security flaws in source code and dependencies, without running the app.
PromptScout
PromptScout tracks how ChatGPT, Gemini, Google AI Overviews, and Perplexity mention your brand or competitors, with source analysis and website audits.
CreateOS Sandbox
CreateOS Sandbox is an isolated compute environment for running code and agent workloads in Firecracker micro-VMs with private networking and SDK, CLI, or MCP control.
Sleek Analytics
Sleek Analytics is a privacy-friendly web analytics tool with real-time visitor tracking, Core Web Vitals, and revenue attribution.
GitBot
GitBot is a local browser workspace for reusable coding bots powered by Claude Code, Codex, or OpenCode, with persistent threads and configurable permissions.