tokenguard
por g0head
AI & LLMsResumen
API cost guardian for AI agents.
Descripción
Qué hace esta skill
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.
Cuándo usarla
- 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
Flujo de trabajo de ejemplo
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
Instalación
clawhub install g0head/tokenguardEjecuta el comando de la CLI o pega el prompt en Claude Code, Cursor, Codex o el agente de programación que uses.