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/trajectonomics/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 Then read every account’s balance and net worth:
traj balance --as-of 2026-03-31 asOf: 2026-03-31
rows:
- account:
id: 01a1ff02-9448-70cc-9da9-0ba9dc6e0149
name: Cash
type: asset
amount: 879.50
currency: THB
- account:
id: 01a1ff02-94a2-737d-bee2-c44a350103a9
name: Food
type: expense
amount: 120.50
currency: THB
- account:
id: 01a1ff02-950a-7437-b8f6-07a7233cf17b
name: Opening
type: equity
amount: -1000.00
currency: THB
netWorth:
- currency: THB
amount: 879.50 --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. Net worth is assets minus liabilities, 879.50 THB here; each account’s id
is its own and differs on your machine. 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, and until traj init has created it every command that reads or writes it fails
with ledger_missing. 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.
The source code lives in
trajectonomics/trajectonomics/apps/cli.