Claude Code Karma
A local dashboard for Claude Code sessions: timelines, token costs, tools, agents, skills and live sessions
Install
git clone https://github.com/JayantDevkar/claude-code-karma.git
cd claude-code-karma/api
pip install -e ".[dev]" && pip install -r requirements.txt
uvicorn main:app --reload --port 8020In a second terminal: cd frontend, npm install && npm run dev, then open http://localhost:5180.
This is third-party code. Review the repository files before installing.
What it does
Karma reads Claude Code session files from ~/.claude and shows them in a web UI on your machine. Each session shows a timeline of prompts and tool calls, tasks, file operations, subagents, skills, background shells and token costs. Global analytics cover cost, cache, models and working rhythm per project, with separate views for tools and MCP, agents, hooks and plugins. A live tracking hook shows active sessions and jumps to their terminal, and the link-ticket-to-session skill ties a session to a Linear, Jira or GitHub ticket.
Who it is for. For heavy Claude Code users who want a clearer view of costs and session history than raw JSONL.
Good fit when
- You want to see where tokens and money go
- You need to find an old session and see what the agent changed
- You want to watch several live sessions at once
Not a fit when
- You do not use Claude Code
- You need server-side team analytics: the dashboard is local
Example request
/link-ticket-to-session ABC-123Limitations
Requires Python 3.10, Node.js 18 and running two servers or the app launcher. Claude Code keeps sessions for about 30 days, and older ones disappear from the dashboard too. Live tracking needs hooks installed per SETUP.md. Costs are estimated from local data and may differ from your bill.
How to disable. Stop the servers, remove Karma hooks from Claude Code settings and the launcher with python3 scripts/install_karma_app.py --uninstall.
Security check
- Reads full session transcripts that may contain secrets
- Installs Claude Code hooks and can add a login item
README in short
The README walks through dashboard sections with screenshots: sessions, session tabs, projects, analytics, tools, agents, hooks, plugins, skills and ticket linking. Quick start runs a FastAPI backend and a SvelteKit frontend, pointing to SETUP.md for live tracking. A launcher installer for macOS and Windows supports autostart. Apache 2.0 licensed.
FAQ
Does Karma send data to the cloud?
No, per the README it runs locally with no accounts or telemetry and only reads files from ~/.claude.
Does Karma change Jira or Linear tickets?
No, it stores only the link and cached title and status, and never writes to the tracker.
Related
Open-source personal AI assistant on your own machine: answers in Telegram, Slack, Discord and WhatsApp, extended with skills and plugins
A self-improving agent from Nous Research with a TUI, messaging gateway, cron jobs and skills it writes itself
An open source coding agent for the terminal and desktop with build and plan modes
Open prompt library with a Claude Code plugin, MCP server and CLI: search, fetch and improve prompts and skills from an agent