Repository files navigation

A cross-platform status bar application that monitors Claude Code usage in real-time. Supports macOS and Ubuntu/Linux.

• Real-time monitoring: Displays current Claude Code session costs in your status bar
• Detailed information: Click to view comprehensive usage statistics
• Live updates: Automatically refreshes every 5 seconds
• Human-friendly display: Shows costs, burn rates, and projections in an easy-to-understand format

Download the latest release for your platform from thereleases page.

git clone https://github.com/sivchari/ccowl.gitcd ccowlgo build -o ccowl./ccowl

• macOS or Ubuntu/Linux
• Claude Code CLI installed and configured
• Theccusage command must be available in your PATH

For Ubuntu/Linux systems, install the required dependencies:

sudo apt updatesudo apt install -y libayatana-appindicator3-dev pkg-config

1. Make sure Claude Code CLI is installed andccusage command is working
2. Run CCOwl:

   ./ccowl

3. The app will appear in your status bar as 🦉 with the current session cost
   • macOS: Status bar in the top menu
   • Ubuntu/Linux: App Indicator in the Gnome top bar
4. Click on the status bar icon to see detailed information:
   • Session timing and remaining time
   • Current cost and burn rate with status indicators
   • Token usage statistics
   • Projected final costs
   • API call counts

• 🟢LOW: < 300 tokens/min
• 🟡MODERATE: 300-700 tokens/min
• 🔴HIGH: > 700 tokens/min

gotest ./...

go vet ./...

MIT License - seeLICENSE file for details.

Pull requests are welcome! Please make sure tests pass before submitting.