Ccowl

CCOwl 🦉

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

Features

- 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

Installation

Download from Releases

Download the latest release for your platform from the releases page.

Build from Source

Requirements

- macOS or Ubuntu/Linux
- Claude Code CLI installed and configured
- The ccusage command must be available in your PATH

Ubuntu/Linux Additional Requirements

For Ubuntu/Linux systems, install the required dependencies:

Usage

1. Make sure Claude Code CLI is installed and ccusage command is working
2. Run 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

Status Indicators

- 🟢 LOW:  700 tokens/min

Development

Running Tests

Running Lint

License

MIT License - see LICENSE file for details.

Contributing

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