@toist/in

The user-facing Toist package. It ships the toist CLI and the project scaffolding templates.

bunx @toist/in

That scaffolds a fresh Toist project in ./toist by default.

Install once, use everywhere

bun add -g @toist/in
toist run pipelines/hello.yml --payload '{"name":"world"}'

Commands

| Command | Purpose | |---|---| | toist init [dir] | scaffold a project or embedded .toist/ home | | toist run <file> | run a spec locally | | toist run <file> --remote <url> | run a spec against a runner | | toist resume <runId> | resume a suspended local run | | toist serve | start the durable runner | | toist tasks list | list open local tasks | | toist tasks answer <id> | answer a task and resume its run | | toist validate <file...> | validate specs | | toist plan <file> | render the DAG as ASCII or DOT | | toist upgrade | bump local @toist/* dependencies |

Run modes

Local toist run defaults to durable CLI storage under XDG_STATE_HOME/toist or ~/.toist/.

toist run approval.yml --payload '{"amount":50}'
toist resume 1 --response '{"approved":true}'

For pipes and generated specs:

cat payload.json | toist run pipelines/hello.yml
echo 'apiVersion: "toist.in/v1"\nid: hello\n...' | toist run --spec-stdin --payload '{}'

For remote execution:

toist serve
toist run pipelines/hello.yml --remote :5172 --payload '{"name":"world"}'
toist tasks list --remote :5172
toist tasks answer 1 --remote :5172 --response '{"approved":true}'

Templates

The wizard ships three templates:

• default — durable runner
• embedded — repo-owned .toist/ runner
• embedded-memory — library-only runSpec() example