Tokemon writes your Claude session percentage, weekly burn, and reset countdown straight into ~/.tokemon/statusline — read it from any zsh, bash, or fish prompt. One-click setup. No scripts to maintain.
Your Claude usage sits in the same prompt you're already looking at every command. No window to switch to, no menu bar to glance up at.
Tokemon polls the Claude usage API and writes the file. Your prompt redraw just reads a tiny cached value — under 1ms overhead.
Green under 50%, orange past 70%, red past 90%. ANSI codes work in every modern terminal — Terminal.app, iTerm2, Alacritty, Ghostty, Warp.
Install Tokemon, enable the statusline export in Settings, then add one line to your shell rc file. The helper script auto-installs to ~/.tokemon/tokemon-statusline.sh.
$ brew install --cask richyparr/tokemon/tokemonOpen Tokemon Settings → Statusline tab → toggle on. Tokemon writes to ~/.tokemon/statusline every poll and drops a helper script next to it.
Add to your .zshrc or .bashrc:
# Tokemon Claude statusline
source ~/.tokemon/tokemon-statusline.sh
# zsh:
PROMPT='$(tokemon_statusline) %~ %# '
# bash:
PS1='$(tokemon_statusline) \w \$ 'Using fish? Read the file directly in your prompt function — no sourcing needed:
# ~/.config/fish/functions/fish_prompt.fish
function fish_prompt
cat ~/.tokemon/statusline 2>/dev/null
echo -n ' '(prompt_pwd)' $ '
endYour current 5-hour rolling window utilization. Resets gradually as old requests age out, not on a fixed clock. Color shifts from green → orange → red as you climb.
Anthropic's 2026 weekly rate limit on top of the 5-hour cap. The most common reason developers see rate-limit errors when their session window looks clear.
Time remaining in the current 5-hour window, calculated from your earliest counted request. Tells you exactly how long until your headroom regenerates.
Tokens-per-hour rate from the past 30 minutes. Useful for predicting whether your current pace will exhaust the window before you wrap up.
The Tokemon statusline outputs plain ANSI-colored text, so it slots into any prompt framework that supports custom segments.
A Claude statusline is a live indicator embedded in your terminal prompt (zsh or bash) that shows your current Claude Code session percentage, weekly utilization, and burn rate. It updates automatically so you can see usage without leaving your editor.
Tokemon writes your live usage to ~/.tokemon/statusline every poll. A small shell helper at ~/.tokemon/tokemon-statusline.sh reads the file and prints colored output. You source the helper in your .zshrc or .bashrc and call it from your prompt.
Yes. The helper script outputs plain ANSI-colored text, so any prompt framework that supports custom segments — Powerlevel10k, Starship, Pure, Oh My Zsh — can include it as a custom segment that runs on each prompt redraw.
Yes. Tokemon is free and open source under the MIT license. The statusline feature is bundled — no subscription, no paid tier, no telemetry.
No. The statusline reads a single small file (~/.tokemon/statusline) on each prompt redraw — typically under 1ms. The actual Claude API polling happens in the background, not on prompt evaluation.
Free, open source, signed and notarized by Apple. Less than a minute from download to live in your prompt.
Download Tokemon for macOS