Metadata-Version: 2.4
Name: claude-monitor-cli
Version: 4.0.0
Summary: A beautiful, interactive terminal monitor for Claude AI usage — real-time quotas, burn rate, cost analytics, and ML predictions.
Project-URL: Homepage, https://github.com/Mohit-Singh2003/claude-monitor-cli
Project-URL: Repository, https://github.com/Mohit-Singh2003/claude-monitor-cli
Project-URL: Issues, https://github.com/Mohit-Singh2003/claude-monitor-cli/issues
Author-email: Mohit Singh <mohitucsss@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: anthropic,claude,claude-code,monitor,terminal,token,tui,usage
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
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 :: Software Development :: Libraries
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Requires-Dist: pydantic-settings>=2.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: textual>=3.0.0
Provides-Extra: dev
Requires-Dist: pytest-cov>=4.0; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: ruff>=0.4.0; extra == 'dev'
Description-Content-Type: text/markdown

# Claude Monitor Tool

Interactive terminal monitor for Claude AI usage — real-time quotas, burn rate, cost analytics, and ML predictions.

## Install

```bash
# From PyPI
pip install claude-monitor-cli

# From source
git clone https://github.com/Mohit-Singh2003/claude-monitor-cli.git
cd claude-monitor-cli
pip install -e .
```

## Usage

```bash
# Interactive TUI (default)
claude-monitor

# Specify your plan
claude-monitor --plan pro       # Pro ($20/mo)
claude-monitor --plan max5      # Max ($100/mo)
claude-monitor --plan max20     # Max ($200/mo)

# Statusline mode (2-line output for Claude Code integration)
claude-monitor --statusline

# Export data
claude-monitor --export json
claude-monitor --export csv

# Debug mode
claude-monitor --debug
```

## Keyboard Shortcuts

| Key | Action |
|-----|--------|
| `r` | Realtime dashboard |
| `d` | Daily usage table |
| `m` | Monthly usage table |
| `s` | Session history |
| `F5` | Force refresh |
| `q` | Quit |

## Features

- **Real-time quota tracking** — 5-hour and 7-day utilization from Anthropic's API
- **Local session analysis** — parses Claude Code JSONL logs for detailed token breakdowns
- **Burn rate analytics** — tokens/min, cost/min, pace indicator
- **P90 predictions** — ML-based limit detection from historical usage
- **Sparkline trends** — 12-hour inline token charts
- **Model breakdown** — per-model (Opus/Sonnet/Haiku) usage distribution
- **Multiple views** — realtime dashboard, daily table, monthly table, session history
- **Statusline mode** — compact 2-line output for Claude Code's status bar
- **CSV/JSON export** — dump usage data for external analysis
- **Claude-native theme** — purple/slate color palette matching Claude Code's aesthetic

## Data Sources

This tool reads from two sources, both on your local machine:

1. **JSONL files** at `~/.claude/projects/` — Claude Code's local session logs (offline, read-only)
2. **Anthropic OAuth API** at `api.anthropic.com/api/oauth/usage` — real-time quota percentages (uses Claude Code's own OAuth token)

No API key required. No data sent to third parties. See [SECURITY.md](SECURITY.md) for full details.

## Requirements

- Python 3.10+
- Claude Code installed and logged in (for data to exist)

## License

MIT
