A tmux plugin that displays Claude AI usage statistics from ccusage in your tmux status bar.

• ccusage must be installed and available in your PATH
• tmux (tested with tmux 2.0+)

1. Add the following line to your ~/.tmux.conf:

set -g @plugin 'yanskun/tmux-ccusage'

2. Press prefix + I to install the plugin.

3. Add ccusage variables to your status bar:

# Example: Add to your status-left or status-right
set -g status-right "#{ccusage_today_cost} #{ccusage_today_tokens} | %Y-%m-%d %H:%M"

4. Reload tmux configuration:

tmux source-file ~/.tmux.conf

1. Clone this repository:

   git clone https://github.com/yanskun/tmux-ccusage.git ~/.tmux/plugins/tmux-ccusage

2. Add this line to your ~/.tmux.conf:

   run-shell ~/.tmux/plugins/tmux-ccusage/ccusage.tmux

3. Reload tmux configuration:

   tmux source-file ~/.tmux.conf

After installation, you can use the following interpolation variables in your tmux configuration:

Add any of these variables to your tmux status bar:

# Show today's cost and tokens in status-right
set -g status-right "#{ccusage_today_cost} #{ccusage_today_tokens} | %Y-%m-%d %H:%M"

# Show cost comparison in status-left
set -g status-left "Today: #{ccusage_today_cost} Yesterday: #{ccusage_yesterday_cost} | "

# Show monthly summary
set -g status-right "Month: #{ccusage_month_cost} Today: #{ccusage_today_cost} | %H:%M"

# Show detailed breakdown
set -g status-right "#{ccusage_today_input_tokens}→#{ccusage_today_output_tokens} #{ccusage_today_cost} | #{ccusage_today_models}"

# Show total usage summary
set -g status-right "Total: #{ccusage_total_cost} (#{ccusage_total_tokens}) | Today: #{ccusage_today_cost}"

• Tokens are automatically formatted with K/M suffixes for readability:
  • 1500 → 1K
  • 1500000 → 1M
• Costs are displayed with dollar sign and rounded to 2 decimal places: $0.12

• The plugin requires ccusage to be installed and accessible in your PATH
• Data is fetched in real-time when tmux refreshes the status bar
• If ccusage is not available, default values ($0.00, 0, none) will be displayed
• The plugin uses basic shell tools for JSON parsing to minimize dependencies

For more comprehensive examples, see .tmux.conf.example which includes various configuration options and color schemes.

1. No data displayed: Ensure ccusage is installed and working:

   ccusage daily --json

2. Permission denied: Make sure scripts are executable:

   chmod +x ~/.tmux/plugins/tmux-ccusage/scripts/*.sh

3. Interpolation not working: If variables like #{ccusage_today_cost} appear literally in your status bar:

   • Make sure the plugin is installed correctly via TPM
   • Try restarting tmux completely: tmux kill-server && tmux
   • For manual installation, ensure you have run-shell ~/.tmux/plugins/tmux-ccusage/ccusage.tmux in your config

4. Slow updates: The plugin fetches data on every status bar refresh. Consider adjusting tmux's status-interval if needed.

MIT