fincraft

Financial analysis reports for a finance vault — a command-line tool that turns a watchlist markdown note into a full markdown performance report.

fincraft is layout-agnostic: it takes explicit paths, parses a watchlist note's frontmatter, and writes a markdown report to stdout (or a file). It reads no environment variables itself and never scans or writes a vault — orchestration (finding notes, saving reports) is the caller's job.

Install

uvx fincraft --help
# or
pip install fincraft

Price data is fetched via bardata; the Tiingo and Massive sources are bundled. The data source and credentials are resolved from the environment (e.g. BARDATA_DEFAULT_ENDOFDAY=tiingo, TIINGO_API_KEY=…).

Usage

fincraft perf-report Watchlists/momentum-etfs.md            # report to stdout
fincraft perf-report Watchlists/momentum-etfs.md -o out.md  # write to a file
fincraft perf-report --tickers QUAL,MTUM,SPY --benchmark SPY

fincraft watchlists Watchlists/        # list watchlist notes in a directory
fincraft show Watchlists/momentum-etfs.md   # parsed frontmatter

Watchlist notes

Any .md note with YAML frontmatter:

---
tickers: [MTUM, SPMO, VFMO]
benchmark: SPY        # or a list [SPY, QQQ]; first is primary
basket: true          # add an equal-weight basket as an extra benchmark
---

See sample-vault/ for a complete worked example.