Starling Bank

Starling is read through starlingcli (npm @howells/starlingcli). If starlingcli isn't on the path, say so and stop; don't install it, clone anything or fall back to browser scraping. Run starlingcli schema before an unfamiliar command rather than guessing flags from names.

starlingcli balance --account all
starlingcli transactions --account personal --since 2026-04-01 --fields date,counterParty,amount,direction,status
starlingcli standing-orders --account business

Every command returns JSON in an {ok, data, error, command, account} envelope. Treat ok: false as a failure and report its error; never read data from a failed call.

Accounts and credentials

Accounts come from variables named STARLING_<NAME>_TOKEN, and <NAME> in lower case is the --account value. The CLI reads only the environment. When a token isn't there, take it from .env at the root of the current repository with the bundled helper, one account per call:

STARLING_PERSONAL_TOKEN="$(python3 scripts/read-credential.py STARLING_PERSONAL_TOKEN)" starlingcli balance --account personal