Metadata-Version: 2.4
Name: claude-usage-bar
Version: 0.2.0
Summary: macOS menu bar app showing Claude API usage limits
Author: dlichtenberg
License-Expression: MIT
Project-URL: Homepage, https://github.com/dlichtenberg/claude_usage_bar
Project-URL: Repository, https://github.com/dlichtenberg/claude_usage_bar
Project-URL: Bug Tracker, https://github.com/dlichtenberg/claude_usage_bar/issues
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: MacOS X
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: rumps<0.5,>=0.4.0
Requires-Dist: pyobjc-framework-Cocoa>=10.0
Dynamic: license-file

# Claude Usage Bar

See your Claude Pro/Max usage at a glance — right in your macOS menu bar.

<img width="277" height="273" alt="Claude Usage Bar screenshot" src="https://github.com/user-attachments/assets/71d950ee-7bc6-4900-abd6-1fcc15164eda" />

## Getting started

Install and run:

```sh
pip install claude-usage-bar
claude-usage-bar
```

To keep it running across restarts, click the menu bar icon and enable **Launch at Login**.

## Requirements

- macOS
- Python 3.10+
- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed and logged in

## How it works

Claude Usage Bar periodically checks your current usage against the Anthropic API and displays a progress bar, so you always know where you stand against your plan's limits. Authentication is handled through your existing Claude Code login.

## Debugging

Set `CLAUDE_USAGE_LOG` for verbose output when running from Terminal:

```sh
CLAUDE_USAGE_LOG=DEBUG claude-usage-bar
```

## Contributing

Contributions are welcome — [open an issue](https://github.com/dlichtenberg/claude_usage_bar/issues) to discuss bugs or ideas.

## License

[MIT](LICENSE)
