agent-usage-tmux

Tmux status bar plugin for showing Claude and Codex usage as compact progress bars.

Install

Add the plugin with TPM:

set -g @plugin 'artischocki/agent-usage-tmux'
set -g status-right "#{claude_usage} | #{codex_usage} "

Then reload tmux or install plugins with TPM.

What It Shows

• Remaining usage percentage
• Time until reset
• Separate bars for Claude and Codex

Current format:

✻ 42% ████▍      03:02
>_ 88% █████▎    00:44

Configuration

By default, the plugin fetches usage from:

• scripts/fetch_claude_usage.py
• scripts/fetch_codex_usage.py

Optional tmux overrides:

set -g @agent_usage_cmd_claude "python3 /path/to/custom_claude_percent.py"
set -g @agent_usage_cmd_codex "python3 /path/to/custom_codex_percent.py"

set -g @agent_usage_reset_cmd_claude "python3 /path/to/custom_claude_reset.py"
set -g @agent_usage_reset_cmd_codex "python3 /path/to/custom_codex_reset.py"

Hide the leading icons:

set -g @agent_usage_show_icons off

That changes the display to:

42% ████▍      03:02
88% █████▎    00:44

Development

Useful local commands:

python3 scripts/fetch_claude_usage.py
python3 scripts/fetch_claude_usage.py --field reset_in
python3 scripts/fetch_codex_usage.py
python3 scripts/fetch_codex_usage.py --field reset_in