Portfolio Daily Tracker Skill
Use Python 3.10+ and the engine scripts installed by scripts/setup.sh.
Read and propose workflow
- Read the latest dated snapshot with
get_tracker_snapshotfor valuations. - Read
/api/ledgerfor confirmed native cash and quantities if the ledger is active. - For an explicit trade, request any missing account, date, currency, quantity, price and fee. Do not infer a price from market quotes or a screenshot.
- Call
propose_ledger_eventsusing the transaction schema indocs/LEDGER.md. - Tell the user nothing has been booked and direct them to
/ledgerto review and confirm. Never call the confirmation API or legacy holdings-writing scripts on their behalf as part of proposal generation. - After confirmation, snapshots can be regenerated independently. Report delivery requires an explicit user-configured destination and authorization.
get_all_tools() now exposes read and proposal tools. The previous direct update
and pipeline tools are no longer registered. Existing external agents should update
their instructions before enabling the ledger. Existing schedulers using legacy
holdings mutation must be disabled before migration.
Installation
bash scripts/setup.sh [target_dir]
For a first look at the complete app, run make setup and make demo in the cloned
repository. The demo is read-only and uses fictional data. For a writable ledger,
use make start, then explicitly confirm opening balances on /ledger.