| name | open-fava |
| description | Open Fava UI on a valid Beancount ledger. Use when fava, browse books, or interactive P&L.
|
/open-fava
Purpose
Fava is the impressive UI on top of Beancount — local browser, not Excel.
ledger/main.beancount → fava → http://127.0.0.1:5000
Preconditions
- Ledger exists (
export-beancount first if not)
bean-check PASS (run validate skill)
fava installed: pip install fava beancount
Command
scripts/run_fava.sh path/to/main.beancount
scripts/run_fava.sh path/to/main.beancount --port 5001
Or:
fava --host 127.0.0.1 --port 5000 path/to/main.beancount
Agent behavior
- Validate ledger first
- Start Fava in background if the host supports long-running processes
- Tell the user the URL:
http://127.0.0.1:5000
- Default bind localhost only — do not expose
0.0.0.0 unless user asks
- If fava missing: print install one-liner; do not pretend UI is open
What to show the user
- Income Statement / Balance Sheet in Fava
- Account tree
- Journal entries from export
Completion
Done when: bean-check PASS, Fava started (or install instructions), user given localhost URL.
Security
Client financial data stays local. No public tunnel unless explicitly requested.