# 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](https://trajectonomics.com/docs/cli/installation/) lists the three channels. On Linux or macOS:

```bash
curl -fsSL \
  https://github.com/trajectonomics/cli/releases/latest/download/install.sh \
  | sh
```

## From an empty machine to a first balance

```bash
# 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](https://trajectonomics.com/docs/cli/commands/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](https://trajectonomics.com/docs/cli/data/) says what else is in the directory, what is safe to
delete, and how to back it up.

## What next

- [Installation](https://trajectonomics.com/docs/cli/installation/): the three install channels, the agent skill, release
  pinning and uninstall.
- [Your data](https://trajectonomics.com/docs/cli/data/): the data directory, backups and a clean removal.
- [Agent](https://trajectonomics.com/docs/cli/agent/): what the Agent asks you for, where the tool stops, and what this release
  does.
- [Configuration](https://trajectonomics.com/docs/cli/configuration/): the environment variables the CLI reads.
- [Commands](https://trajectonomics.com/docs/cli/commands/): the command reference.

Source code and design decisions live in
[`trajectonomics/cli`](https://github.com/trajectonomics/cli).

Part of the [Docs index](https://trajectonomics.com/docs/llms.txt).
