ynabing

ynabing is a local-first CLI for reconciling YNAB with banks, credit cards, screenshots, statements, and eventually receipts.

The first workflow extracts Apple Card transactions from iPhone screenshots using macOS Vision OCR, normalizes a YNAB CSV export, and produces an ordered comparison report.

Layout

.
├── data/
│   ├── iphone-screenshots/
│   └── ynab-export/
├── reports/
├── src/ynabing/
├── tests/
├── pyproject.toml
└── ynabing.toml.example

The repository does not track financial data, screenshots, exports, or generated reports.

Install for development

cd "$MATRIX/packages/ynabing"

export UV_PROJECT_ENVIRONMENT="$APOGEE_UV_VENV_ROOT/ynabing"

uv sync --all-groups
uv run ynabing --help

Configure paths

Local repository configuration:

uv run ynabing config init       --path "$PWD/ynabing.toml"       --data-root "$PWD/data"       --reports-root "$PWD/reports"

Or define a global data location:

export YNABING_DATA_ROOT="/path/to/ynabing-data"

Resolution order:

1. CLI options
2. YNABING_DATA_ROOT and YNABING_CONFIG_FILE
3. ./ynabing.toml
4. ~/.config/ynabing/config.toml
5. ./data and ./reports

Apple Card reconciliation

Put screenshots in:

data/iphone-screenshots/

Put the YNAB export in:

data/ynab-export/

Then run:

uv run ynabing apple-card reconcile       --as-of 2026-06-23       --exclude-top 0.12

When --ynab is omitted, the newest CSV in data/ynab-export/ is selected.

Reports are written to:

reports/apple-card/YYYY-MM-DD/

Generated files include:

• apple_transactions.csv
• ynab_transactions.csv
• ordered_comparison.csv
• screenshot_counts.csv
• top_anchor_candidates.csv
• summary.txt

Roadmap

• Generic account and institution adapters
• Statement reconciliation
• Pending authorization tracking
• Cross-month authorization/posting detection
• Receipt indexing and attachment paths
• Duplicate and amount-change detection
• Persistent local database
• Optional YNAB API integration

Privacy

Transaction exports, screenshots, receipts, and reports remain local. Do not commit them to Git.

License

MIT