plugin

budgetclaw — Claude Code plugin: spend tracking and caps

Q: How do I install budgetclaw in Claude Code?

From the marketplace: run `/plugin marketplace add anthropics/claude-plugins-community` first, then `/plugin install budgetclaw@claude-community`.

Q: What has to be in place before the plugin works?

The monitor itself: `curl -fsSL https://roninforge.org/get | sh` followed by `budgetclaw init`. Without it the session-start hook only reports that budgetclaw is missing.

Tracks spend per project and branch, watches your budget caps, and kills the session when a cap is breached.

Install into Claude Code · Plugin marketplace All methods and platforms ↓

/plugin marketplace add anthropics/claude-plugins-community
/plugin install budgetclaw@claude-community

Open on GitHub

What budgetclaw does

budgetclaw ships a /spend slash command and a session-start hook for Claude. The command reports what you have spent broken down by project and branch, which budget limits are active, and any breach locks. The hook prints a short spend summary whenever a new session starts; if budgetclaw is missing, it says so instead.

The monitor itself is a separate install: curl -fsSL https://roninforge.org/get | sh, then budgetclaw init. Skip that and the session-start hook has nothing to report. Caps are set per project and per branch, and enforcement runs through SIGTERM, so the process is terminated rather than merely flagged.

Inside the plugin there is a manifest at .claude-plugin/plugin.json, the hook file hooks/hooks.json, and the skill skills/spend/SKILL.md that backs the slash command.

What it helps with

see what a single project has already cost
compare spend across working branches
set a spending ceiling and stay under it
get a budget summary the moment a session opens
find out why a session was cut short

Example prompts for the agent

Show my current spend for this project and branch
Which budget limits are active right now?
Are there any breach locks on this project?

How to install budgetclaw

Plugin marketplace

/plugin marketplace add anthropics/claude-plugins-community

/plugin install budgetclaw@claude-community

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about budgetclaw

How do I install budgetclaw in Claude Code?

From the marketplace: run /plugin marketplace add anthropics/claude-plugins-community first, then /plugin install budgetclaw@claude-community.

What does budgetclaw do?

It reports spend by project and branch, shows active budget limits and breach locks, and terminates the process with SIGTERM once a cap is exceeded.

What has to be in place before the plugin works?

The monitor itself: curl -fsSL https://roninforge.org/get | sh followed by budgetclaw init. Without it the session-start hook only reports that budgetclaw is missing.

Source text

plugin · MIT

# BudgetClaw Claude Code Plugin

Adds a `/spend` slash command and a session-start hook to Claude Code.

## What it does

- **`/spend`** - Shows your current spend by project and branch, active budget limits, and any breach locks
- **Session start hook** - Prints a brief spend summary when you start a new Claude Code session (or a "not installed" notice if budgetclaw is missing)

## Prerequisites

BudgetClaw must be installed:

```sh
curl -fsSL https://roninforge.org/get | sh
budgetclaw init
```

## Install the plugin

```sh
claude plugin install ./plugin
```

Or for development, point Claude Code at this directory:

```sh
claude --plugin-dir ./plugin
```

## Plugin structure

```
plugin/
  .claude-plugin/
    plugin.json          manifest
  hooks/
    hooks.json           session-start hook
  skills/
    spend/
      SKILL.md           /spend slash command
```

caveman-discover JuliusBrussee Finds and labels every LLM workflow in your repository so Caveman Cloud breaks down spend by actual job rather than grouping everything into one bucket. CX Codex +1 104,400installs omni-budget cheaper-inference Sets spending limits, token quotas and rate-limit policies per key or globally. Shows current consumption and enforces cost controls across providers. CX Codex +1 973installs cost-budget-check ruvnet Adds up what the project has spent, compares it with the budget limit and names the alert level. Worth running before you spawn another round of agents. CX Codex +1 692installs cost-summary ruvnet Extracts a single-shot cost snapshot across models, tiers, and sessions in JSON or markdown. Useful for scripts, bots, and budget tracking. CX Codex +1 683installs setup-development-environment davila7 A slash command that builds out a dev environment: runtimes, tooling, build setup, linters, configs. Handy when you spin up a project on a fresh machine. 651installs ad-spend-allocation Maya-Beth Finotti This skill splits one fixed paid-media budget across campaigns, platforms and funnel stages using marginal return instead of average. CX Codex +1 20,600installs