tokenwatch-docs

Installation

Standard install

pip install tokenwatch

Install in a virtual environment (recommended)

python3 -m venv venv
source venv/bin/activate        # Windows: venv\Scripts\activate
pip install tokenwatch
tokenwatch

Verify the install

tokenwatch --help

You should see the list of available commands.

Update to the latest version

pip install --upgrade tokenwatch

TokenWatch shows a banner in the dashboard when a new version is available.

Uninstall

pip uninstall tokenwatch

Your config and price cache at ~/.claude/tokenwatch_*.json are not removed automatically. Delete them manually if needed.

Configuration file location

~/.claude/tokenwatch_config.json

Key	Default	Description
daily_budget	10.00	Daily spend limit in USD
alert_at_pct	[80, 100]	Alert thresholds (% of budget)
history_days	7	Days of history shown (Free: max 7, Pro: max 90)
port	7842	Server port
open_browser	true	Auto-open browser on start
digest_email	””	Weekly digest email address (Pro only)