Metadata-Version: 2.4
Name: claude-usage
Version: 0.0.13
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/anderslatif/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
```

---

## How it works

The data is retrieved from Anthropic's Messages API (`/v1/messages`) via the OAuth token saved in the macOS Keychain by Claude Code. 

The API is polled every 60 seconds to provide the session / weekly limits and reset countdown for both. 


