Free Plugin for Claude Code
What is Claude Code loading before you type, and what does it cost?
Every session starts with tens of thousands of tokens you never wrote, re-read on every request. The plugin shows how many, what carrying them costs, and what to turn off.
- Runs locally from Claude Code's own logs
- Prompts and code are never read into a report
- Free, open source, no account
/plugin marketplace add ProdMoh/ganivra-claude-plugin/plugin install ganivra@ganivraThen run /ganivra:audit · MIT licence · Python 3.8+ · macOS and Linux
Starting context, last 30 days
- Median before your first prompt
- 68.5k tokens
- Carrying it cost
- $106 · 16% of usage
- From MCP servers and skills
- 7.3k
- Claude Code system prompt and tools
- 61.2k
Loaded vs used
- marketing plugin19 sessionsused 0
- browser MCP server19 sessionsused 0
- xlsx skill19 sessionsused 1
“My sessions start with 68.5k tokens before I type.”
Three commands
Answers you can't get from /cost.
Each command runs a small local script and shows the result in your session. The plugin itself adds about 82 tokens to each session.
/ganivra:auditWhat loads before you type
Tokens in your starting context (median, range and weekly trend), what carrying them costs, how much comes from MCP servers and skills you can switch off, and which of those you loaded but never used. Ends with the top three things to turn off.
/ganivra:reportWhere the money went
Whether your plan is worth it (usage at API rates against what you pay), then cost by project, model and day for the last 7 or 30 days, and what the same tokens would have cost on Sonnet 5.5 or Haiku 5.5. It also exports CSV.
/ganivra:setupA status line that's always on
Session cost, context used, plan-limit usage and reset time, today's total across all sessions, and the project. It asks before changing your settings.
Status line example. On Pro and Max plans, ≈ marks the API-rate value of your usage, not what you are billed.
Privacy
Your logs stay on your machine.
The plugin is plain Python with no dependencies and no network calls. Read the source before you install it.
Read
- Token counts and model names
- Timestamps and sessions
- Tool, skill and folder names
Never read or sent
- Prompts and responses
- Source code and files
- Anything over the network
Questions
Claude Code plugin FAQ
Updated
What does the Claude Code plugin cost?
Nothing. It is free and open source under the MIT licence, needs no account, and has no paid tier. Ganivra's paid product is team-wide tracking, which is separate.
How is this different from /context?
/context shows the breakdown of the current session. The audit looks across every session in the last 30 days: the trend of your starting context, what carrying it cost, and which MCP servers and skills were loaded in many sessions but used in almost none.
Does it send my data anywhere?
No. It reads Claude Code's own logs on your machine, uses only token counts, model names, timestamps, tool and skill names and folder names, and makes no network requests. Prompts, responses and code are never read into a report or stored.
Does it work on Claude Pro and Max?
Yes. On a subscription, costs show what the same usage would cost at API list rates, marked with ≈, because your plan is a flat fee. The status line also shows your five-hour and weekly limit usage when Claude Code reports them.
Why can't I find it in the Claude plugin directory?
Not yet listed there. Install it from GitHub with the two commands on this page; it is the same plugin.
What does it need?
Claude Code with plugin support and Python 3.8 or later, which macOS and most Linux systems already have. It has no other dependencies.
How do I remove it?
Run /plugin uninstall ganivra@ganivra, delete ~/.ganivra/claude-code, and remove the statusLine entry from ~/.claude/settings.json if you installed the status line.
Running Claude Code across a team?
The plugin covers one machine. Ganivra tracks Claude Code and Codex for the whole team, by developer, project and client, with one command per machine.
/plugin marketplace add ProdMoh/ganivra-claude-plugin