Configuration
The environment variables the Trajectonomics CLI reads.
The CLI is configured through environment variables; there is no configuration file. A flag beats
the environment: --json beats TRAJ_FORMAT.
Only the environment of the shell that runs traj counts. A .env or bunfig.toml file in the
directory you run it from is never read, so a cloned project cannot point traj at another ledger.
bunx is the one exception: Bun reads bunfig.toml itself before traj starts, so use the install
script or npx inside a directory you do not trust.
TRAJ_HOME
The data directory, default ~/.traj. It holds traj.db, the SQLite database, and the npm
launcher’s bin/ cache of downloaded binaries. Override it to keep several ledgers apart, and see
Your data for the directory’s contents, backups and removal:
TRAJ_HOME=/tmp/traj traj init --json TRAJ_FORMAT
human (the default) or json. --json takes precedence over the environment. An unrecognized
value falls back to human and is reported as text with exit code 2.
TRAJ_DEBUG
Set to 1 to print diagnostics for unexpected errors on stderr.
Building from source
TRAJ_BINARY_PATH points the npm launcher at a binary you built yourself. Building the CLI from
source is for contributors, described in the
repository, not here.