Skip to content
Back to skills

Budget

ASecurity

Show or change TokenTab's spending limits (session, daily, warnings, hard stop). Use when the user asks, in the same prompt, to see or change a TokenTab limit, e.g. "raise my daily limit to 30" or "hard stop on". Never change a limit unasked.

  • 11 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added November 18, 2026
ai-agentspythonapi

Works with

  • claude code
  • api

Security analysis

A100/100

Scanned November 18, 2026

npx -y skills add getsupertab/claude-marketplace --skill budget --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Budget?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Budget
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/getsupertab-budget/badge)](https://www.skillsdirectory.com/skills/getsupertab-budget)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: budget
description: Show or change TokenTab's spending limits (session, daily, warnings, hard stop). Use when the user asks, in the same prompt, to see or change a TokenTab limit, e.g. "raise my daily limit to 30" or "hard stop on". Never change a limit unasked.
argument-hint: "[what to change]"
---

# TokenTab budget

The limits live in one file, under Claude Code's config folder: `$CLAUDE_CONFIG_DIR` when
that is set, else `~/.claude`:

    <config folder>/plugins/data/tokentab-supertab/budget.json

It belongs to the user. Plugin updates never change it; uninstalling the plugin deletes
it together with the rest of TokenTab's data.

Arguments: $ARGUMENTS

## No arguments: show the limits

Read the file and show, in a short list: whether `budgets_on` is on (off, or missing,
means none of the limits below are checked), the unit in effect, its two limits (`null` means off), `warn_at_percent` and `hard_stop` (true blocks at 100%,
false only warns). "Turn budgets on/off" means `budgets_on`.

The account decides what the limits count; it is not a setting. Percent of the plan's
usage windows (`five_hour_limit_percent`, `weekly_limit_percent`) where Claude Code reports
them (Pro, Max), else USD (`session_limit_usd`, `daily_limit_usd`; Enterprise, API key).
`state/rate_limits.json` beside budget.json holds the last reading: windows listed means
percent. If the user asks to switch units, say the account sets it. A
limit the user names without a unit ("daily limit 30") is the one of the unit in effect
(today in USD, this week in percent). Give the file path, and mention that
the user can ask for a change with `/tokentab:budget <what to change>`.

## With arguments: change the limits

1. Work out exactly which keys change and to what, and show the change (old → new)
   before writing. If the request is ambiguous, ask.
2. Change each key through the validator, one call per key, never by editing the file:

       python3 "${CLAUDE_PLUGIN_ROOT}/tokentab/budget.py" set KEY VALUE

   Where `python3` is missing or is not Python 3 (Windows), run the same with `python`, else `py -3`, in its place.
   KEY is dotted for nested settings (`cold_resume.confirm_seconds`); VALUE is a number, `off` for a
   limit switched off, `on`/`off` for a switch. It refuses a value that does not fit or a
   key that does not exist, and keeps the file's order and comments. `budget.py get` prints
   the file.
3. Show the new values. They apply from the next prompt; no restart is needed. The same
   limits are editable in the TokenTab pane's Options tab.

TokenTab tells Claude never to raise a limit on its own. That rule is about Claude
acting unasked; this skill acts only on what the user asked for in the same prompt. If TokenTab blocks the edit anyway (for example
during a hard stop), give the user the path so they can edit the file themselves.

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.