tokenguard
por g0head
AI & LLMsResumo
API cost guardian for AI agents.
Descrição
O que esta skill faz
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.
Quando usá-la
- 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
Exemplo de fluxo de trabalho
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
Instalação
clawhub install g0head/tokenguardExecute o comando da CLI ou cole o prompt no Claude Code, Cursor, Codex ou no agente de código que você usa.