Download all docs

The Triform CLI

Triform ships a single CLI binary available under three names: triton (the primary), with triform and triform-cli kept as aliases for existing automation.

Install

One command installs the CLI and the MCP server into ~/.triform/bin:

curl -fsSL https://triform.cloud/downloads/install.sh | sh

The installer detects your OS/arch (Linux and macOS, x86_64 and arm64), downloads the matching prebuilt binary, verifies its SHA-256 checksum, and installs triton, triform, triform-cli, and triform-mcp. Pin a version with TRIFORM_VERSION=…, or change the install dir with TRIFORM_BIN_DIR=….

Windows: use the PowerShell installer instead — irm https://triform.cloud/downloads/install.ps1 | iex.

macOS: the binaries are not yet notarized; the installer clears the Gatekeeper quarantine attribute for you.

Add ~/.triform/bin to your PATH if the installer reports it isn’t already.

Authenticate

triton auth login            # interactive login (opens the browser)
triton auth set-api-key      # use a bearer token (trif_…) instead
triton auth status           # show who you're authenticated as
triton config show           # show the resolved circle + URLs

For production (triform.cloud) and CI, mint a trif_ token from an api-token element in your circle and use triton auth set-api-key — see Authentication & access.

Chat (Triton)

triton                       # open Triton chat; prompts for login when needed
triton "your prompt"         # open chat with an initial prompt
triton -p "your prompt"      # print one response and exit
triton -p --raw "prompt"     # print only the response body and exit
triton -c                    # continue the latest chat
triton -r <conversation>     # resume a specific chat

Calling elements (generated tool commands)

Every element operation is reachable as a CLI command. The shape is uniform:

triton <tool> <action> [--field value ...]
triton <tool> --action <action> [--field value ...]
triton <tool> --input '{"field":"value"}'
triton <tool> --help
triton tools                 # list the available tools

The same compact tool catalog is exposed over MCP and the HTTP API, so a workflow you script with the CLI is callable verbatim from an agent or a backend.

Related