Skip to content
TakoAPI
Back to skills

tokenguard

by g0head

AI & LLMs
1.6kDownloads reported by clawskills.sh
3Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

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

INPUT

User asks: check if I can afford a $5 API call, then log the actual cost

AGENT
  1. 1

    Run tokenguard status to see current limit and remaining balance

  2. 2

    Run tokenguard check 5.00 to verify the estimated cost fits the budget

  3. 3

    Call the external API if exit code is 0

  4. 4

    Run tokenguard log 4.23 "Claude Sonnet - summarization" to record the actual cost

  5. 5

    Run tokenguard history to confirm the entry was saved

OUTPUT

Spending log updated: $4.23 recorded, remaining balance displayed

Installation

clawhub install g0head/tokenguard

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links