Metadata-Version: 2.4
Name: money-tui
Version: 0.1.0
Summary: Terminal finance dashboard. Drop bank statements into Claude Code, get a TUI.
License: MIT
Project-URL: Homepage, https://github.com/Viaaaron/money-tui
Project-URL: Repository, https://github.com/Viaaaron/money-tui
Keywords: finance,tui,terminal,dashboard,budget,claude
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console :: Curses
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Office/Business :: Financial
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: sqlalchemy>=2.0
Requires-Dist: click>=8.1
Dynamic: license-file

# money-tui

Terminal finance dashboard. Drop bank statements into Claude Code, get a retro TUI. Data stays local in SQLite on your machine.

No API keys. No cloud sync. No account linking. Just your statements and a terminal.

## Install

```bash
pip install money-tui
```

## Try it

```bash
money demo
```

Fake data, 4 views, keyboard nav. Press `D` `B` `C` `T` to switch views, `Q` to quit.

## Use it

```bash
money setup     # creates local SQLite database
money tui       # dashboard with your real data
```

### Import your statements

Open Claude Code in the same directory:

```bash
claude
```

Then drop a bank statement (CSV or PDF) into the conversation:

```
Here's my Chase statement for January [attach file]
```

Claude reads the statement, categorizes every transaction, and stores it locally. Run `money tui` to see your dashboard.

Works with any bank — Claude figures out the format. No parser config needed.

## Views

| Key | View | What it shows |
|-----|------|--------------|
| `D` | Dashboard | Cash flow, bills due, income, recent transactions |
| `B` | Budget | Spending vs limits, progress bars, over/under alerts |
| `C` | Charts | Monthly trends, category breakdown, daily heatmap |
| `T` | Transactions | Full transaction list with totals |
| `R` | Refresh | Reload data from database |
| `Q` | Quit | Exit |

## How it works

```
You                    Claude Code                SQLite
 │                         │                        │
 ├── drop statement ──────►│                        │
 │                         ├── read & categorize ──►│
 │                         │                        │
 ├── money tui ───────────────────────── read ──────┤
 │◄──────────────────────── terminal dashboard ─────┤
```

- **Claude Code** is the parser. It reads any bank statement format and handles categorization.
- **SQLite** stores everything locally. Your financial data never leaves your machine.
- **money-tui** is the visualization layer. Pure Python, no dependencies beyond SQLAlchemy and Click.

## Data

Everything lives in `./data/money.db`. The database has:

- **accounts** — your bank accounts and credit cards
- **transactions** — every transaction, categorized
- **categories** — Groceries, Dining, Coffee, Shopping, etc.
- **budgets** — monthly spending limits
- **bills** — recurring bills with due dates

## Built with

[Claude Code](https://claude.ai/code) — the AI does the boring part (parsing statements, categorizing transactions). You get the fun part (the dashboard).
