simple-usage-monitor

simple-usage-monitor is a command-line interface (CLI) tool designed for real-time monitoring of token usage and cost estimates when working with Claude Code, all directly within the terminal. This utility enhances productivity by eliminating the need to switch between various dashboards or web interfaces, allowing users to stay focused on their coding tasks.

Key Features

• Live Usage Data: View current token counts for input, output, and cache as you work.
• Cost Tracking: Monitor expenses associated with token usage, featuring tiered pricing models tailored to your subscription.
• Session Management: Keep track of session limits based on the selected plan to avoid unexpected charges.
• Privacy: All computations are conducted locally, ensuring that usage data remains confidential and secure.

Supported Models

• Opus 4.5
• Sonnet 4.5
• Haiku 4.5

While additional models provide detailed token counting, dollar cost metrics are currently limited to the supported models.

Getting Started

To begin using simple-usage-monitor, simply run the command:

sumonitor

This command automatically detects the installation of Claude Code, initiates it with an integrated monitoring overlay, and displays real-time usage statistics directly in your terminal.

Command Line Options

Customize your monitoring experience using the following options:

sumonitor [OPTIONS]

• --plan {pro,max5,max20}: Choose your Claude subscription plan (default: pro).
• --path PATH: Specify a custom path to the Claude Code binary (default is auto-detection).
• --version: Display version information.
• -h, --help: Show detailed help messages.

Contribution Opportunities

Contributions are welcomed to further enhance simple-usage-monitor. Potential areas for development include:

• Adding support for more Claude models
• Improving error handling mechanisms
• Introducing additional usage data export formats
• Enhancing the user interface
• Refining overlay functionalities

For detailed instructions and guidelines on contributing, please refer to the CONTRIBUTING.md file.

Changelog

Find version history and release notes in the CHANGELOG.md.

Acknowledgments

The development of simple-usage-monitor has been inspired by the works from the Claude Code Usage Monitor.
This project aims to simplify the user experience while remaining focused on immediate needs during code execution.

Harness the power of simple-usage-monitor to effectively manage your Claude Code usage and associated costs without losing your workflow.