Quickstart
Install the Trajectonomics CLI and record your first transaction.
traj is a command-line tool for your own money. It keeps a double-entry ledger in one file on your
machine and answers questions about balances, net worth and what comes next. It computes; the Agent
that runs it supplies the judgement.
Install
Installation lists the three channels. On Linux or macOS:
curl -fsSL \
https://github.com/trajectonomics/cli/releases/latest/download/install.sh \
| sh From an empty machine to a first balance
# create ~/.traj and an empty database
traj init
# an asset account, an expense account, and the equity account an opening balance needs
traj account add Cash --type asset --currency THB
traj account add Food --type expense --currency THB
traj account add Opening --type equity --currency THB
# fund Cash at the start of the record, then spend from it
traj tx add --opening --from Opening --to Cash --amount 1000.00 --date 2026-01-01
traj tx add --from Cash --to Food --amount 120.50 --date 2026-03-01
# every account's balance and net worth
traj balance --as-of 2026-03-31 --type and --currency are required when adding an account, and THB is the only currency this
release supports. --as-of is required on balance. Every date a command acts on is YYYY-MM-DD,
and it is always one you pass.
traj tx add --opening is how a ledger gets its first money: --from names the equity account the
amount posts against. On this ledger the balance prints Cash 879.50 THB, Food 120.50 THB and
Opening -1000.00 THB, and net worth (assets minus liabilities) is 879.50 THB. Without the
opening balance Cash holds -120.50 THB, and the Baseline refuses
the ledger rather than state a negative asset.
Where your data lives
traj init writes ~/.traj/traj.db, or $TRAJ_HOME/traj.db when TRAJ_HOME is set. That one file
is the ledger. Your data says what else is in the directory, what is safe to
delete, and how to back it up.
What next
- Installation: the three install channels, the agent skill, release pinning and uninstall.
- Your data: the data directory, backups and a clean removal.
- Agent: what the Agent asks you for, where the tool stops, and what this release does.
- Configuration: the environment variables the CLI reads.
- Commands: the command reference.
Source code and design decisions live in
trajectonomics/cli.