trigora

trigora command [options] [args]

trigora is the CLI for Trigora, a durable-execution platform for long-lived programs and agents. You write ordinary TypeScript, Python, or Rust. At durable boundaries, Transparent Continuation Checkpointing (TCC) commits the program position and live state; recovery resumes from that continuation instead of replaying history.The command name is trigora. Install with pip install trigora-cli (Python 3.10–3.14; console script wraps a vendored native binary), cargo install trigora-cli, or npm install trigora (Node 22 launcher). The Python wrapper execs `vendor/trigora`, or **TRIGORABIN if set, and sets TRIGORALOCALBIN for the local runtime. Crate/package line 1.0.3**. MIT (CLI, SDKs, contracts). TCC Engine is Business Source License 1.1.`trigora dev` spawns trigora-local, which drives tcc-host-sqlite and persists continuations in `.trigora/state.db`. Dual-target commands (programs, executions, start, send, result, cancel) talk to that local runtime unless --remote. deploy, whoami, and secrets always use Trigora Cloud and need TRIGORA_TOKEN.

trigora.toml

Project file: `[project]` name and `programs` globs (for example `programs = ["src/**/*.ts"]`). Program id is the named default export

TRIGORA_TOKEN for Cloud. init writes a commented example

Cloud API token (environment or `.env`)

Override the native trigora / trigora-local binaries (Python launcher)

Local SQLite continuation store used by trigora-local

init

Scaffold the current directory. --language `typescript`|`python`|`rust` (prompts on a TTY; TypeScript if none). --name, --example / --no-example, -f / --force. Writes `trigora.toml` and `.env.example`

Local HTTP runtime. --host (default localhost), --port (default 3477)

Start a program. --input JSON text or a JSON file (omitted input is `[]`). --remote

Deliver an event. --payload JSON text or file. --remote

Cancel, or fetch the result. --remote

List programs or executions, or show one. --remote

Compile discovered programs and upload them to Cloud. --program name limits to one. Needs TRIGORA_TOKEN

Print the Cloud workspace for TRIGORA_TOKEN

Cloud project secrets for the name in `trigora.toml`. set reads the value from a hidden prompt or stdin, never as an argument

Local healthy-run benchmark, or crash-after-checkpoint recovery checks. --input, --effects, --events, --out. verify --faults `sample` (default) or `all`. These do not start dev and do not target Cloud

Cloud commands need TRIGORA_TOKEN. Dual-target commands default to trigora dev, not Cloud; pass --remote. npm trigora and the TypeScript adapter need Node 22. Python-only and Rust-only projects do not start Node. If the Python package's vendored binary is missing, the wrapper exits 1 with "Reinstall trigora-cli."

Trigora is built by Trigora, Inc. CLI 1.0.3. TCC Engine is a separate source-available repository.

python(1), pip(1), npm(1), cargo(1), node(1)

Source code · Homepage · Documentation