CLI

The same verbs as the SDK, one command each.

Configure

The binary reads TERRARIUM_API_KEY and TERRARIUM_BASE_URL. terrarium configure prompts for a key and writes ~/.config/terrarium/config.toml.

Config precedence: environment, then config file.

terrarium configure
terrarium me
terrarium version

Verbs

Command	Does
`terrarium configure`	Prompt for key; write config.toml
`terrarium me`	Org, scopes, capabilities
`terrarium scenarios`	List scenarios; `--shared` / `--mine`
`terrarium worlds create\|list\|get`	Create, list, or show a world
`terrarium step WORLD -n N`	Advance and wait; `--watch` for live progress
`terrarium watch WORLD`	Live summary until settled or interrupted
`terrarium pause WORLD`	Stop after the tick in flight
`terrarium characters WORLD`	List the cast
`terrarium perceive WORLD NAME`	Show what one character can see
`terrarium act WORLD NAME ACTION`	Stage one character's next attempt
`terrarium summary WORLD`	Where everyone is and the last thing that happened
`terrarium keys list\|create\|revoke`	Manage API keys
`terrarium version`	Package version

terrarium scenarios
terrarium worlds create --scenario grocery
terrarium worlds list
terrarium worlds get WORLD_ID
terrarium step WORLD_ID -n 2 --watch
terrarium watch WORLD_ID
terrarium pause WORLD_ID
terrarium characters WORLD_ID
terrarium perceive WORLD_ID Derek
terrarium act WORLD_ID Derek "count the register and lock the back door"
terrarium summary WORLD_ID

Machine output

--json on every read verb prints the raw response for scripts. Tables are for people. Errors print as one line and exit 1; auth errors say where keys come from.