Commands
Game commands
Section titled “Game commands”| Command | Description |
|---|---|
trail tui |
Launch the full-screen Textual UI. L opens the ledger menu; with the backpack on, R proofs this save (does not Rest). c cycles pace. |
trail tui --seed <n> |
Start with a specific seed (reproducible world) |
trail tui --continue |
Resume a saved game |
trail tui --voice |
Enable voice narration (requires Ollama) |
trail tui --gm-off |
Disable AI narration |
trail tui --gm-profile <name> |
Set GM profile: chronicler, fireside, lantern |
trail tui --model <name> |
Ollama model name (default: llama3.2) |
trail tui --voice-pace <pace> |
Voice pacing: fast, normal, slow |
trail tui --callouts <mode> |
Warning mode: verbose (default) or minimal |
trail new |
Start a new run (classic CLI mode) |
trail new --weirdness <0-3> |
Weirdness level for GM (default: 2) |
trail play |
Continue a saved run (classic CLI mode) |
Status commands
Section titled “Status commands”| Command | Description |
|---|---|
trail status |
Show party, wagon, and supplies |
trail journal |
Show recent journal entries |
trail journal -n <count> |
Show last N journal entries |
trail stats |
Show run statistics |
trail stats --json |
Output run statistics as JSON |
trail version |
Show version |
trail self-check |
Check game environment health |
Ledger commands
Section titled “Ledger commands”| Command | Description |
|---|---|
trail ledger enable |
Enable XRPL backpack |
trail ledger disable |
Disable XRPL backpack |
trail ledger status |
Show backpack status |
trail ledger settle |
Manually settle a checkpoint |
trail ledger reconcile |
Retry failed settlements |
trail ledger proof |
Proof the loaded save (PASS/FAIL/INCONCLUSIVE) |
trail ledger wallet |
Show wallet details |
Parcel commands
Section titled “Parcel commands”| Command | Description |
|---|---|
trail parcel send <addr> <supply> <amount> |
Send supplies to another traveler via XRPL |
trail parcel list |
List received parcels |
trail parcel accept <id> |
Accept a pending parcel |
trail parcel sent |
List parcels you have sent |
Wallet commands
Section titled “Wallet commands”| Command | Description |
|---|---|
trail wallet share |
Print your wallet address for trading |