Your data
Where the Trajectonomics CLI keeps the ledger, what is safe to delete, and how to back it up.
traj is a local tool. It keeps one SQLite database on your machine, uploads nothing, and has no
account to cancel. This page says where that database is, what else lives beside it, and which of
the two is safe to delete.
The data directory
All state is one directory, ~/.traj on every platform, or the value of TRAJ_HOME when
that is set. traj init creates it:
traj init traj init creates the directory readable only by you (mode 0700) and the ledger the same way
(mode 0600), and every later command keeps the ledger at 0600. A directory that already exists
keeps the mode you gave it.
Two children matter:
| Path | What it is | Safe to delete? |
|---|---|---|
traj.db | The ledger: every account, transaction, correction, Scenario and tax Levy, in one SQLite file. | No. It is the only copy. |
bin/ | The npm launcher’s cache of downloaded release binaries, about 100 MB per version. | Yes. The next npx run downloads again. |
The install scripts do not use bin/: they put the binary where the platform expects it, and the
directory then holds the ledger alone.
Back it up
Before you delete anything, take the copy you would keep:
traj backup --out ~/traj-backup The backup writes traj.jsonl into a directory that must not already exist, and
traj restore reads it back into an empty database.
traj export writes the same JSONL plus CSV and Markdown, which do not restore.
Remove traj, keep the ledger
Delete the program and the caches. Installation lists each path. The ledger stays where it is, and a later install opens the same books.
Remove the ledger too
Delete the whole data directory yourself:
rm -rf ~/.traj Use "$TRAJ_HOME" instead when you set it:
rm -rf "$TRAJ_HOME" That deletes the database, and there is no copy anywhere else unless you made one above.
To remove only the ledger and keep the data directory, use traj data remove.
It deletes the database files and nothing else, and it refuses unless a backup holds exactly the data
as it is now. traj scenario rm tombstones one Scenario, and no other command deletes accounts or
transactions.
Keep several ledgers apart
Point TRAJ_HOME at another directory to keep two sets of books on one machine:
TRAJ_HOME=~/money/work traj init
TRAJ_HOME=~/money/work traj balance --as-of 2026-03-31 Each directory is complete on its own: its own traj.db, its own bin/ cache, and nothing shared
with the default ~/.traj.
Previous: Installation · Next: Agent.