budgetclaw

A Claude Code spending tracker that reads local session logs, records usage by project and branch, and can send data to a shared team dashboard.

In plain words
What is it for?
Tracking AI spending across projects, branches, and machines; setting budget caps; and reviewing team usage in one dashboard.
Why use it?
It shows how much Claude Code work is costing and can stop a session when its budget limit is reached.

Plugin for Claude Code

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Claude Code
/plugin marketplace add RoninForge/budgetclaw
agentmods
npx agentmods add plugins/roninforge/budgetclaw/plugin
Clone the repo
git clone --depth 1 https://github.com/RoninForge/budgetclaw

Made for: Claude Code.

Per session not measured What this adds to a session before it is invoked.
When invoked not measured Not applicable: nothing here is loaded into a session.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Security

Grade A, and why

budgetclaw scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugin/.claude-plugin/plugin.json · 37 lines

What it actually says

{
  "name": "budgetclaw",
  "version": "0.1.0",
  "description": "Zero-key Claude Code cost tracking, per project and per branch. Budget caps with SIGTERM enforcement, reads your local ~/.claude session logs, and syncs to a hosted team dashboard (Goei).",
  "author": {
    "name": "RoninForge",
    "url": "https://github.com/RoninForge"
  },
  "homepage": "https://roninforge.org",
  "repository": "https://github.com/RoninForge/budgetclaw",
  "license": "MIT",
  "keywords": [
    "spend-monitor",
    "budget",
    "cost",
    "claude-code",
    "telemetry",
    "claude-ai",
    "ccusage",
    "cost-tracking",
    "usage-tracking",
    "token-usage",
    "claude-code-analytics",
    "claude-tracker",
    "claude-max",
    "claude-subscription",
    "cost-dashboard",
    "ai-spend",
    "llm-cost",
    "multi-machine",
    "team",
    "burn-rate"
  ],
  "skills": "./skills/",
  "hooks": "./hooks/hooks.json"
}
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 37 lines scan A b246417b86e1

Subscribe to this mod's changes

budgetclaw is a plugin published in the GitHub repository RoninForge/budgetclaw (8 stars, last pushed 2d ago), licensed MIT. Its token cost is not measured: this kind of file is read by the harness, not the model. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.