Skip to content

CLI

Agent quickstart
Terminal window
npm install trigora

The npm package provides a Node launcher for the Rust CLI. Node.js 22 and 24 are supported for the npm CLI launcher and TypeScript adapter. Python-only and Rust-only projects do not require Node.js. See Install. Authentication uses TRIGORA_TOKEN; the CLI does not provide a trigora login command.

TRIGORA_TOKEN authenticates Trigora Cloud. It does not choose the target of a runtime command.

These commands target trigora dev by default. Add --remote to target Trigora Cloud. --remote requires TRIGORA_TOKEN.

CommandWhat it does
trigora programsList programs
trigora executionsList executions
trigora executions inspect <id>One execution
trigora start <program>Start an execution
trigora send <id> <event>Deliver an event
trigora cancel <id>Cancel
Terminal window
# Local — default
trigora programs
trigora executions
trigora executions inspect <id>
trigora start approval
trigora send <id> approved
trigora cancel <id>
# Trigora Cloud
trigora programs --remote
trigora executions --remote
trigora executions inspect <id> --remote
trigora start approval --remote
trigora send <id> approved --remote
trigora cancel <id> --remote

--input and --payload are JSON, or a path to a JSON file. --input is the ordered argument vector when it is a JSON array. A single JSON value is one argument. Omitting it sends {}.

Terminal window
trigora start approval --input '{"note":"stored"}'
trigora send <id> approved --payload '{"ok":true}'

trigora deploy, trigora secrets, and trigora whoami always talk to Trigora Cloud. They require TRIGORA_TOKEN. They do not take --remote.

CommandWhat it does
trigora deployCompile and upload to Cloud
trigora secretsList, set, or delete project secrets
trigora whoamiWorkspace for the Cloud token
Terminal window
export TRIGORA_TOKEN=...
trigora deploy
trigora deploy --program approval
trigora secrets set OPENAI_API_KEY
trigora whoami

trigora secrets set reads the value from a prompt or stdin. See Secrets.

trigora bench and trigora verify run in-process on a temporary SQLite host. They do not start trigora dev, and they do not talk to Trigora Cloud. See Benchmark and verify.

Terminal window
trigora bench my-program
trigora verify my-program --faults all

trigora pulse runs a customer-operated host. It is not trigora dev and it is not trigora deploy.

CommandPurpose
trigora pulse startCompile this project, start the Pulse host, and start the Node adapter beside it
trigora pulse connect --dir /pulseRegister handlers with a host that is already running
trigora pulse connect --dir /pulse --prepareWrite the handler manifest and exit without registering
Terminal window
export TRIGORA_TOKEN=...
trigora pulse start
trigora pulse connect --dir /pulse
trigora pulse connect --dir /pulse --prepare

trigora pulse start requires TRIGORA_TOKEN unless you pass --ephemeral. The token stays on the host. --ephemeral keeps the checkpoint in memory and does not recover after the host exits. Do not combine TRIGORA_TOKEN with TRIGORA_PULSE_AUTHORITY_URL, TRIGORA_PULSE_WORKSPACE_ID, or TRIGORA_PULSE_WORKSPACE_TOKEN.

trigora pulse start prints ready after the adapter registers. It does not create an execution. trigora start targets trigora dev, or Trigora Cloud with --remote. It is not the Pulse start path. The application starts an execution by sending { type: "start", executionId } on the adapter session. The Compose reference does that when PULSE_EXECUTION_ID is set. See Node and Deploy.

--dir is the socket directory the host already bound. Both sides must run as the same user.

CommandWhere it runs
trigora devLocal SQLite runtime
trigora deployTrigora Cloud
trigora pulse startYour host, with Trigora storing the checkpoint
CommandWhat it does
trigora initWrites the scaffold for TypeScript, Python, or Rust
trigora devLocal runtime on localhost:3477

trigora dev follows the chain in the CLI reference: trigora spawns trigora-local, which drives tcc-host-sqlite.

Terminal window
trigora dev --host localhost --port 3477

Full flags, including per-language init files: CLI reference.