Release history
evan-moon/firma releases
Local-first CLI asset tracker for overseas stock investors with Claude Desktop MCP integration. 13 tools for portfolio tracking, net worth snapshots, cash flow analysis, and market research (earnings, insider trades, SEC filings)
All releases
49 shown
Instructions, investigation protocol, projection prompt
Drawdown, 5y percentile, milestones, YLD@COST, rebalance hint
- `firma portfolio` → `firma show portfolio`
- `firma txns` → `firma show txns`
- `firma balance` (interactive) → `firma add balance`
- CLI restructured into verb groups: add, show, report
- `firma edit balance [period]` pre‑fills existing values in the add wizard
- `firma delete balance [period]` removes all entries for a period
Full changelog
Highlights
- CLI restructure into verb groups:
firma add,firma show,firma report. Drop the--jsonmagic toggle that conflated input and read modes. - Edit and delete for balance/flow:
firma edit balance [period]re-runs the add wizard with existing values pre-filled.firma delete balance [period]drops every entry for a period. - Auto-sync in show portfolio:
firma show portfolionow refreshes Finnhub prices first; pass--no-syncto skip. firma add monthlyreplacesfirma settlefor combined month-end entry.firma report settlereplacesfirma settle --jsonfor the read-only summary.- Bug fixes: MCP avg-cost calculation no-op (
totalCostnever reduced on sell),periodEndDatetimezone bug, exchange-rate validation accepting non-positive values.
MCP
All tools renamed to add_* / show_* / report_* for parity with the CLI. New tools: delete_balance, delete_flow, report_settle. add_balance/add_flow remain upserts and act as edit when the composite key matches.
Breaking changes
This is a 0.x release with no backward-compatible aliases.
firma portfolio→firma show portfoliofirma txns→firma show txnsfirma balance(interactive) →firma add balancefirma balance --json→firma show balance --jsonfirma flow→firma add flow/firma show flow --jsonfirma settle→firma add monthly/firma report settlefirma news/insider/financials/earnings→firma show ...firma edit/delete(top-level) →firma edit/delete txn- MCP
get_*→show_*,set_*→add_*,get_period_summary→report_settle