CLI Reference

Terminal access to projects, gates, incidents, proof, and execution surfaces.

The CLI enforces the same governance as the dashboard: no mutation without proof, no execution without approval.

Installation

The CLI is available by repo install. Package distribution is not yet published.

cd clipip install -e .

Requires Python 3.10+. Installs as the gatestack command.

export GATESTACK_API_KEY=gs_live_your_key_here

Or use gatestack auth login for interactive authentication.

gatestack versionDisplay CLI and API version

gatestack healthCheck API health and readiness

gatestack configShow current CLI configuration

gatestack projects listList projects in your organization

gatestack projects get <id>Get project detail

gatestack gates pendingList pending approval gates

gatestack gates get <id>Get gate detail and history

gatestack directives createCreate a draft directive from the terminal

gatestack incidents get <id>Get Watchman incident detail

gatestack surfaces registerRegister this machine as an execution surface

gatestack surfaces meGet current surface identity

gatestack surfaces heartbeatSend heartbeat to the Control Plane

gatestack surfaces stop-statusCheck Emergency Stop status

gatestack surfaces assignmentGet current execution assignment

gatestack tasks listList tasks for current assignment

gatestack tasks get <id>Get task detail

gatestack tasks start <id>Start a task

gatestack tasks complete <id>Complete a task with outputs

gatestack tasks fail <id>Fail a task with error

gatestack proof readinessCheck proof readiness for current execution

gatestack proof submitSubmit a proof packet

gatestack proof latestGet latest proof packet