CLI Reference

Tormoni provides a single binary, tormoni, for managing sandboxes.

Basic Commands

Verb	What it does
tormoni run -- CMD	Runs one command in a fresh sandbox and exits with its status.
tormoni shell	Opens an interactive session (or any command) on a pty in a fresh sandbox.
tormoni up --name NAME	Starts a sandbox that outlives the command, reachable afterwards by name.

Managing Runs

Verb	What it does
tormoni ls	Lists the sandboxes running on this machine; --all adds the ended runs.
tormoni exec NAME -- CMD	Runs a command in a sandbox that is already up; --tty attaches a terminal.
tormoni stop NAME	Stops a running sandbox.
tormoni show ID	Prints one run’s record: what it could touch, what it printed, what it wrote.
tormoni rm ID	Removes one run’s record and everything it captured.
tormoni export ID	Writes one run as a ustar .tar (--to picks a directory or an exact path).

Note: show, rm, and export can take either a run id or a name.

Configuration resolution

Resolved in precedence order, first match winning:

1. Command line flags.
2. Environment variables (e.g., $TORMONI_VCPUS, $TORMONI_MEM_MIB, $TORMONI_GUEST_ROOT, $TORMONI_RUNS_DIR, $TORMONI_RUNS_KEEP, $TORMONI_OUTPUT_CAP_KIB, $TORMONI_LOG, $TORMONI_CLI, $TORMONI_THEME).
3. The nearest .tormoni.toml in or above the current working directory.
4. User defaults in ~/.tormoni.toml.
5. Built-in defaults.