What is token-budget?
token-budget is a Claude Code mod by Plagemes that set a token or dollar budget per session; get warned at 80% and stopped at 100%. It is listed under Cost & usage and has 1 GitHub stars.
| Type | Claude code mod |
|---|---|
| Author | Plagemes |
| Repository | Plagemes/claude-mods |
| Popularity | 1 GitHub stars |
| Category | Cost & usage |
| Security | Low risk (88/100) |
| Rank | #2,242 of 5,272 Claude Code mods; #375 in Cost & usage |
| License | MIT |
| Last commit | 2026-10-15 |
| Hooks | 5 events |
| Sees | every prompt |
| Draws on | AbovePrompt |
Is token-budget safe to install?
token-budget scores 88/100 on the MCPMods security check: Low risk. Things to review: watches every prompt or event. It passed 7 of 8 checks.
Mod footprints come from claude plugin validate, which lists every event a mod hooks and every API call it makes without running it.
| Check | Result |
|---|---|
| No network access | Pass |
| Starts no processes | Pass |
| Writes no files or config | Pass |
| Doesn't read environment variables | Pass |
| Watches every prompt or event | Review |
| Doesn't drive Claude | Pass |
| Passes claude plugin validate | Pass |
| Has an open-source license | Pass |
API calls in its code
| Call | What it means |
|---|---|
$.clock.after | |
$.command.register | |
$.fs.read | reads files |
$.mods.hello | |
$.mods.mode | |
$.mods.notify | |
$.mods.publish | |
$.mods.registerTab | |
$.mods.share | |
$.state.get | |
$.state.set | |
$.ui.log | draws interface |
$.ui.resolve | draws interface |
$.ui.toast | draws interface |
How do I install token-budget?
- Check your Claude Code version. Mods need Claude Code 2.1.287 or later and are on by default.
claude --version
- Read its footprint. This lists every event it hooks and every API call it makes, without running it.
git clone https://github.com/Plagemes/claude-mods claude plugin validate ./claude-mods/mods/token-budget
- Install it. Run this in your terminal, then /reload-plugins in an open session.
claude plugin marketplace add Plagemes/claude-mods && claude plugin install token-budget@claude-mods
Or ask Claude to set it up
Paste this into Claude Code and it installs token-budget for you:
Install the "token-budget" Claude Code mod from https://github.com/Plagemes/claude-mods/tree/main/mods/token-budget. Run claude plugin validate on it first and show me what it can access before you enable it.
More from Plagemes/claude-mods
This repository has at least 9 Claude Code mods on MCPMods.
- a11y-guard: Flags accessibility misses as Claude writes UI: images without alt, unlabeled buttons, clickable divs. (Low risk)
- achievements: Unlock achievements as you work: first commit, 100 green test runs, a week-long streak and more. (Low risk)
- activity-heatmap: A heat map of when you use Claude Code, by hour and weekday. (Low risk)
- agent-presets: Ready-made subagents for focused jobs: debugger, test writer, doc writer and migrator. (Low risk)
- audit-trail: Writes every action Claude takes to an append-only JSONL audit log. (Review before installing)
- auto-checkpoint: Snapshots your work tree before every editing turn and lets you /rollback to any checkpoint. (Low risk)
- auto-format: Formats every file Claude edits with the right formatter for its language. (Low risk)
- autopilot: Give it a goal and success criteria; it plans, delegates, verifies and retries until the criteria pass or it needs you. (High risk)