tmux-ccusage

tmux-ccusage

A tmux plugin to display Claude API usage information in your status bar.

繁體中文 | English

Features

- 📊 Display daily/monthly/session costs
- 💰 Show remaining subscription quota
- 📈 Usage percentage with color-coded warnings
- ⚡ 30-second caching to minimize API calls
- 🎨 Multiple display formats
- 🔧 Support all ccusage command options
- 🎯 Comprehensive test coverage (TDD)
- 🚀 Pure bash implementation (no dependencies)
- 🎭 Dracula theme integration

Requirements

- tmux 2.1+
- ccusage CLI tool
- bash

Installing ccusage

Installation

Option 1: Using TPM (Recommended)

1. Add to .tmux.conf:

2. Press prefix + I to install

Option 2: Manual Installation

Add to .tmux.conf:

Quick Start

Minimal Setup

Add to .tmux.conf:

Reload tmux configuration:

Advanced Setup

Available Format Strings

Note: If you set @ccusage_prefix, it will be prepended to all standard formats (but not custom).

Configuration

Basic Settings

Time Range Settings

Custom Format

Use placeholders to create custom formats:

Color Settings

Currency Symbol

Global Prefix

Dracula Theme Integration

If you're using Dracula tmux theme, tmux-ccusage integrates automatically!

Dracula Integration Options

Control how tmux-ccusage integrates with Dracula:

Dracula Display Options

Customize the display prefix and format:

Manual Integration

If you prefer manual setup:

Dracula Display Formats

- status - Full status: Claude $160.55/$200 (80.3%)
- remaining - Remaining quota: Claude $39.45/$200
- percentage - Usage percentage: Claude 80.3%
- today - Today's cost: Claude $17.96
- total - Total cost: Claude $160.55

Troubleshooting

No Output Displayed

1. Check if ccusage is installed:

2. Test ccusage:

3. Test the plugin directly:

Clear Cache

Configure Claude API Key

ccusage…