Skip to Content

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.