Commands

Reference for the helios command groups, global flags, and JSON output when piped.

Every command follows the same shape.

helios <group> <command> [arguments] [flags]

Run any group without a command to see its help.

helios workflow --help

Output

The CLI picks the output format from where it is going. In a terminal it prints tables. When you pipe it, it prints JSON.

helios workflow list | jq '.[].id'

You can force a format.

helios workflow list --json
helios workflow list --output table

Pick only the fields you want.

helios chat list --json --fields id,title

Errors are JSON too when the format is JSON. Every failure maps to an exit code and prints the server message. A 403 says there is no access, or the resource does not exist.

Global flags

These flags work on every command.

Flag	What it does
`-o, --output <format>`	`json`, `table`, or `text`. Default picks by terminal.
`--json`	Short for `--output json`.
`-q, --quiet`	Minimal output.
`-v, --verbose`	Debug details on stderr.
`--no-input`	Never prompt. Fail if input is needed.
`--yes`	Confirm destructive commands without asking.
`--project <id>`	Project scope for this one call.
`--context <name>`	Use a named context.
`--server <url>`	Point at a different Helios server.
`--limit <n>`, `--offset <n>`	Page through list results.
`--fields <fields>`	Comma-separated output fields.
`--dry-run`	Preview changes without applying.
`--no-color`	Disable ANSI colors.

Environment variables HELIOS_API_KEY, HELIOS_SERVER, and HELIOS_PROJECT set the same values without flags.

Command groups

Group	Commands	Example
`auth`	`login`, `logout`, `list`, `status`, `whoami`	`helios auth whoami`
`chat`	`new`, `send`, `list`, `use`, `get`, `fork`, `rename`, `delete`, `share`, `export`	`helios chat send "Summarize open PRs in acme/api"`
`workflow`	`list`, `get`, `create`, `update`, `delete`, `trigger`, `runs`, `run-get`, `run-output`, `cancel`	`helios workflow trigger <id>`
`project`	`list`, `use`, `get`, `create`, `update`, `delete`	`helios project use "engineering digests"`
`integration`	`list`, `get`, `test`, `connect`, `finish`, `wait`, `authorize`, `authorization`	`helios integration connect github`
`variable`	`list`, `get`	`helios variable get REGION`
`secret`	`list`, `get`, `create`, `update`, `delete`	`helios secret create --name DB_URL --value <value>`
`mcp-server`	`list`, `get`, `test`	`helios mcp-server test <id>`
`network`	`list`, `get`, `set`, `delete`	`helios network get`
`share`, `unshare`	Grant or revoke a role on any resource	`helios share workflow/<id> --with group:oncall --role operator`
`access`	`list`	`helios access list workflow/<id>`
`shared`	`list`	`helios shared list`
`group`	`list`, `get`, `create`, `rename`, `delete`, `member add`, `member remove`	`helios group member add oncall user:<id>`
`service-account`	`list`, `get`, `create`, `rename`, `disable`, `enable`, `delete`, `assign`, `unassign`	`helios service-account disable deploy-bot`
`code`	`list`, `launch`, `get`, `attach`, `kill`, `logs`, `events`, `environments`, `images`, `apply`, `iac`	`helios code launch <environment-id> --attach`
`context`	`create`, `use`, `list`, `current`, `set`, `delete`, `path`	`helios context current`
`search`	Search across resources	`helios search "digest"`
`skills`	`install`, `uninstall`, `list`	`helios skills install claude-code`
`mcp`	`list`, `status`, `test`	`helios mcp status`
`configure`	Guided setup	`helios configure --redo iac`
`doctor`	Check system readiness	`helios doctor`
`docs`	Show CLI documentation	`helios docs`
`schema`	Dump the command tree as JSON	`helios schema --tree`
`completion`	Shell completions	`helios completion zsh`
`update`	Update the binary	`helios update --check`
`version`	Version, commit, build date	`helios version`

Chat

Start a chat in the terminal app, or send one message and read the answer.

helios chat -p "List the failing runs from this week"

Continue the last chat with -c. Resume a specific one with -r <id>.

helios chat send "And who owns them?" --continue

Workflows

Trigger a workflow and watch its runs.

helios workflow trigger <id> --input '{"repo":"acme/api"}'
helios workflow runs <id> --watch

Read the transcript of one run.

helios workflow run-output <workflow-id> <run-id>

Create a workflow with a schedule trigger.

helios workflow create --name "Weekly PR digest" --prompt "..." --trigger-cron "0 9 * * 1"

Integrations

Connect an OAuth integration from the terminal. The command prints the id and an auth URL and returns at once.

helios integration connect github

Open the URL in a browser. Then wait for the connection to finish.

helios integration wait <id> --timeout 600

Connect a Claude account for Helios Code. This flow asks for a code after sign-in.

helios integration connect claude_account
helios integration finish <id> --code <code>

For a GitHub org install, each person authorizes their own user.

helios integration authorize <id>
helios integration wait <id> --until authorized

Filter the list by service or status.

helios integration list --service github --status connected

Credential-based integrations such as Stripe and Resend are connected from the dashboard. See authentication.

Coding agents

helios code launch <environment-id> --git-repo https://github.com/acme/api --attach
helios code logs <agent-id> --follow
helios code events <agent-id> --follow
helios code kill <agent-id> --yes

events streams NDJSON, one event per line. See Helios Code and IaC.

Access

See projects and access for share, unshare, access, shared, group, and service-account.

Machine-readable schema

Agents and scripts can read the full command tree, with every flag and argument, as JSON.

helios schema --tree

Pass a command path to get one subtree.

helios schema code launch

On this page