simplefin-cli

CLI client for the SimpleFin Bridge Protocol

npm install -g simplefin-cli

Exchange a SimpleFin setup token for a persistent access URL:

simplefin-cli setup <base64-token>

Check current configuration:

simplefin-cli status

List all financial accounts:

simplefin-cli account list
# or shorthand:
simplefin-cli accounts

List all transactions across all accounts:

simplefin-cli transaction list
# or shorthand:
simplefin-cli transactions

Filter by account:

simplefin-cli transactions --account-id <id>

Filter by date range (ISO 8601):

simplefin-cli transactions --start-date 2024-01-01 --end-date 2024-12-31

Remove stored access URL and configuration:

simplefin-cli reset

All commands output JSON to stdout:

{ "ok": true, "accounts": [...] }
{ "ok": false, "error": { "code": "SETUP_REQUIRED", "message": "..." } }

Exit code 0 on success, 1 on error.

MIT