Metadata-Version: 2.4
Name: claude-usage
Version: 0.0.11
Summary: macOS menu bar app for Anthropic API usage and cost tracking
Project-URL: Repository, https://github.com/anderslatif/claude-usage
Author: Anders Latif
License: MIT
Keywords: anthropic,api,claude,macos,menu-bar,usage
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: MacOS X
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Utilities
Requires-Python: >=3.11
Requires-Dist: keyring>=25.6.0
Requires-Dist: pyobjc-framework-coretext>=12.1
Requires-Dist: pyobjc-framework-quartz>=12.1
Requires-Dist: python-dotenv>=1.0.1
Requires-Dist: requests>=2.32.3
Requires-Dist: rumps>=0.4.0
Description-Content-Type: text/markdown

# Claude Usage Mac Menu

[![](https://img.shields.io/pypi/v/claude_usage.svg)](https://pypi.org/pypi/claude_usage/)


<img src="https://raw.githubusercontent.com/ailabexperiments/claude-usage/main/assets/menu_item_example.png" alt="doctordoc logo" width="350" >


A macOS menu bar app that shows your Anthropic API spend and token usage in real time - like a battery indicator for your API budget.

---

## Get started

```bash
$ pip install claude-usage
$ claude-usage
```

**Pre-requsite**: Having authenticated with Claude Code:

```bash
$ claude-code login
```

---

## How it works

The data is retrieved from Anthropic's Usage API with the OAuth token saved by Claude Code in your macOS Keychain. 

which provides up-to-date information on your organization's API usage and costs. The app polls the API every 60 seconds and updates the menu bar title and dropdown with your current token usage and session / weekly reset window.

