sumonitor 0.1.0

Real-time token and cost monitoring overlay for Claude Code CLI with session tracking

simple-usage-monitor

In-terminal (HUD) usage monitoring for Claude Code - see your costs without leaving your workflow

Unlike other monitoring tools that require opening separate dashboards or browsers, sumonitor displays your usage data right in your terminal in real-time as you work. No context switching.

• Live token counts (input, output, cache)
• Cost tracking with tiered pricing
• Session limits based on your plan
• Time until session reset

All processing happens locally on your device - your sessions remain completely private.

Supported Models

1. Opus 4.5
2. Sonnet 4.5
3. Haiku 4.5

Other models will still have accurate token counting, just not dollar cost.

Installation

Install from PyPI (Recommended)

pip install sumonitor

Install from source

1. Clone the repo

   git clone https://github.com/SrivathsanSivakumar/simple-usage-monitor

2. Then install the tool

   cd path/to/simple-usage-monitor

   pip install -e .

Uninstallation

pip uninstall sumonitor

Usage

Simply run:

sumonitor

This will:

1. Auto-detect your Claude Code installation
2. Start Claude Code with the monitoring overlay
3. Show real-time usage at the bottom of your terminal

Command Line Options

sumonitor [OPTIONS]

Options:

• --plan {pro,max5,max20} - Your Claude subscription plan (default: pro)

  • pro: Claude Pro plan limits
  • max5: Max 5 plan limits
  • max20: Max 20 plan limits

• --path PATH - Custom path to Claude Code binary (default: auto-detect)

• --version - Show version information

• -h, --help - Show help message

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

Areas for contribution:

• Support for additional Claude models
• Enhanced error handling
• Additional export formats for usage data
• UI improvements
• Overlay functionality improvements

Changelog

See CHANGELOG.md for version history and release notes.

Acknowledgments

Big thanks to Claude Code Usage Monitor for the inspiration and awesome work!