tokenguard
by g0head
AI & LLMsBrief
API cost guardian for AI agents.
Description
What This Skill Does
TokenGuard tracks API spending per session, enforces configurable dollar limits, and blocks actions when budgets are exceeded. It logs every cost with timestamps and provides pre-flight budget checks before expensive calls.
Unlike ad-hoc manual tracking, TokenGuard enforces limits programmatically via exit codes, so scripts and agents can gate expensive operations without any custom logic.
When to Use It
- Stopping a runaway agent loop before it burns $200 overnight
- Setting a $10 daily cap during development of a new AI feature
- Auditing which operations consumed the most API budget last week
- Scripting a CI pipeline that skips expensive calls when over budget
- Extending a session limit mid-task without losing the spending history
Example Workflow
User asks: check if I can afford a $5 API call, then log the actual cost
- 1
Run
tokenguard statusto see current limit and remaining balance - 2
Run
tokenguard check 5.00to verify the estimated cost fits the budget - 3
Call the external API if exit code is 0
- 4
Run
tokenguard log 4.23 "Claude Sonnet - summarization"to record the actual cost - 5
Run
tokenguard historyto confirm the entry was saved
Spending log updated: $4.23 recorded, remaining balance displayed
Installation
clawhub install g0head/tokenguardRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.