Skip to main content
For the complete documentation index optimized for AI agents, see llms.txt.
This page lists every command in Helix CLI v2. Click any command for full flag and example details.

​
Global Options

These options are available for every command: 
helix --help, -h        Show help for the command
helix --version, -V     Print the CLI version
helix --quiet           Suppress output (errors and final result only)
helix -v, --verbose     Show detailed output with timing information

​
Commands

CommandSubcommandsFlagsScopeDescription
helix initlocal, enterprise-p/--pathLocal, Helix CloudInitialize a v2 Helix project
helix chefLocalBootstrap a first Helix app with skills, docs MCP, starter queries, seed data, and a launched coding agent
helix addlocal, enterpriseLocal, Helix CloudAdd an instance to an existing project
helix start--foreground, --port, --disk, --persistLocalStart a local instance (background by default)
helix stopLocalStop a background local instance
helix restartLocalRestart a background local instance
helix statusLocal, Helix CloudShow instance status
helix logs-f/--follow, -r/--range, --start, --endLocal, Helix CloudView instance logs
helix query-f/--file, --json, -e/--ts, --ts-file, --warm, --host, --port, --compactLocal, Helix CloudSend a dynamic query (JSON or TypeScript DSL) to POST /v1/query
helix authlogin, logout, create-keyHelix CloudManage Helix Cloud authentication
helix workspacelist, show, switch--format, --idHelix CloudManage active workspace selection
helix projectlist, show, switch--format, --id, --workspace-idHelix CloudManage linked project selection
helix clusterlist, indexes--format, --workspace-id, --project-id, --cluster-idHelix CloudList Helix Cloud clusters and their indexes
helix pushHelix CloudDeploy a Helix Cloud instance to Helix Cloud
helix sync--dry-run, -y/--yesHelix CloudRefresh Helix Cloud instance metadata in helix.toml
helix prune-a/--all, -y/--yesLocalRemove Helix-owned local containers, volumes, and workspaces
helix delete-y/--yesLocal, Helix CloudDelete an instance from helix.toml and local state
helix skillsinstall, update, list--project—Install, update, and list the Helix agent skills
helix metricsfull, basic, off, statusLocal, Helix CloudConfigure CLI telemetry
helix update--force, --v1—Update the CLI (and refresh installed skills) to the latest version
helix feedback—Send feedback to the Helix team
helix config is retained as a hidden compatibility alias. Use helix workspace, helix project, and helix cluster directly — they’re the canonical commands.

​
Next Steps

Local Development

The local init/run/query loop

Helix Cloud

Authenticate, link a project, and query a Helix Cloud cluster