Metadata-Version: 2.4
Name: myburn
Version: 0.1.0
Summary: Your Claude Code dashboard — track burn, YOLO mode, score cards. 100% local.
Project-URL: Homepage, https://myburn.cc
Project-URL: Repository, https://github.com/Gekko-dot-ETH/myburn
Author: MyBurn Contributors
License-Expression: MIT
License-File: LICENSE
Keywords: ai,claude,claude-code,dashboard,tokens,usage
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.9
Requires-Dist: fastapi>=0.100.0
Requires-Dist: uvicorn[standard]>=0.20.0
Description-Content-Type: text/markdown

# MyBurn 🔥

**Your Claude Code Dashboard** — track your burn, tokens, YOLO mode, and flex your 14 score cards. 100% local, zero telemetry, open source.

## Install

```bash
pip install myburn
```

Then open [localhost:7734](http://localhost:7734) — that's it.

## Features

- **Burn Tracking** — real-time cost tracking with daily, monthly, and per-project breakdowns
- **14 Score Cards** — from Clean to Roast to YOLO Mode, share your stats in style
- **YOLO Stats** — track how much of your burn happens with bypass permissions
- **Live VU Meter** — 32-segment LED bar with 3-second polling
- **Hourly Patterns** — see when you code most
- **Session Details** — per-session cost, duration, and tool breakdown
- **Project Breakdown** — which projects burn the most

## How it works

1. **Install** — `pip install myburn`, one command
2. **Reads your local logs** — parses `~/.claude/projects/` JSONL files
3. **Dashboard opens** — your browser opens at `localhost:7734` with all your stats

Nothing leaves your machine — ever. No accounts, no telemetry, no cloud.

## CLI options

```
myburn                    # Start dashboard, open browser
myburn --port 8080        # Custom port
myburn --no-browser       # Don't auto-open browser
myburn --host 0.0.0.0     # Bind to all interfaces
myburn --version          # Show version
```

## Data directory

By default, MyBurn stores its SQLite database in `~/.myburn/data/`. Override with:

```bash
MYBURN_DATA_DIR=/path/to/data myburn
```

## Running from source

```bash
git clone https://github.com/Gekko-dot-ETH/myburn.git
cd myburn
pip install -e .
myburn
```

## Privacy

MyBurn extracts only aggregate metrics from your Claude Code logs:

- Token counts and model names
- Timestamps and session durations
- Cost calculations (API-equivalent pricing)
- Tool usage counts
- Permission mode (YOLO detection)

It **never** reads, logs, or transmits your code, prompts, file paths, or any conversation content.

## License

MIT
