CLI Reference

CLI pre-beta: The cendriix npm package is not published yet. Design partners use the web app at app.cendriix.ai. Commands below are the target interface.

Overview

Command	Description
`cendriix init`	Create a new workspace
`cendriix login`	Authenticate the CLI
`cendriix run`	Trigger and manage runs
`cendriix logs`	Stream run logs
`cendriix workspace`	Manage workspaces and connectors
`cendriix replay`	Time-travel replay of past runs
`cendriix policy`	Manage guardrail policies
`cendriix audit`	Query and export audit events

cendriix init

Scaffolds a workspace configuration and authenticates the session.


cendriix init [workspace-slug]

Flag	Default	Description
`--region`	`us-east-1`	Primary cloud region
`--plan`	`starter`	Billing plan: `starter`, `growth`, `enterprise`
`--no-browser`	—	Print the auth URL instead of opening a browser tab

Authenticates or re-authenticates the CLI.


cendriix login [--workspace <slug>]
cendriix login --token $CENDRIIX_TOKEN   # CI / non-interactive

cendriix run

Trigger a workflow run, approve/reject a paused run, or cancel.


cendriix run <workflow> [options]
cendriix run approve --run <run-id>
cendriix run reject  --run <run-id> [--note "reason"]
cendriix run cancel  --run <run-id>

Flag	Description
`--ticket`	Jira / Linear ticket key to attach
`--dry-run`	Plan without executing; print agent chain + estimated cost
`--env`	Target environment: `preview`, `staging`, `production`
`--model`	Override the default LLM
`--run`	Run ID for approve/reject/cancel. Use `latest` shorthand
`--note`	Human note attached to approve/reject events


cendriix run ship-from-ticket --ticket JIRA-3421
cendriix run approve --run latest --note "LGTM"

cendriix logs

Stream or retrieve structured logs.


cendriix logs [--run <run-id>] [--follow] [--level <level>]

Flag	Default	Description
`--run`	`latest`	Run ID
`--follow`	`false`	Stream live logs (SSE)
`--level`	`info`	Minimum: `debug`, `info`, `warn`, `error`
`--output`	`pretty`	Format: `pretty` or `json`

cendriix workspace


cendriix workspace list
cendriix workspace switch <slug>
cendriix workspace cloud connect --provider aws
cendriix workspace cloud disconnect --provider aws

cendriix replay


cendriix replay <run-id> [--step <n>] [--policy <file>]

cendriix policy


cendriix policy list
cendriix policy apply <file.yaml>
cendriix policy validate <file.yaml>
cendriix policy diff <file.yaml>

cendriix audit


cendriix audit [--run <run-id>] [--from <date>] [--to <date>] [--format json|csv]

Global flags

Flag	Description
`--workspace`	Override the active workspace
`--output`	`pretty` (default), `json`, `yaml`
`--verbose`	Enable debug logging
`--no-color`	Disable ANSI colour output

Environment variables

Variable	Description
`CENDRIIX_TOKEN`	Service-account token for non-interactive auth
`CENDRIIX_WORKSPACE`	Default workspace slug
`CENDRIIX_API_URL`	Override API base URL (default: `https://api.cendriix.ai/v1`)