> ## Documentation Index
> Fetch the complete documentation index at: https://docs.helix-db.com/llms.txt
> Use this file to discover all available pages before exploring further.
# CLI Command Reference
> Complete reference for all Helix CLI v2 commands and options
> For the complete documentation index optimized for AI agents, see [llms.txt](/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:
```bash theme={"languages":{"custom":["languages/helixql.json"]}}
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
| Command | Subcommands | Flags | Scope | Description |
| :---------------------------------------------------- | :------------------------------- | :------------------------------------------------------------------------------------------- | :----------------- | :--------------------------------------------------------------------------------------------------------- |
| [`helix init`](/cli/command-reference/init) | `local`, `enterprise` | `-p`/`--path` | Local, Helix Cloud | Initialize a v2 Helix project |
| [`helix chef`](/cli/command-reference/chef) | | | Local | Bootstrap a first Helix app with skills, docs MCP, starter queries, seed data, and a launched coding agent |
| [`helix add`](/cli/command-reference/add) | `local`, `enterprise` | | Local, Helix Cloud | Add an instance to an existing project |
| [`helix start`](/cli/command-reference/start) | | `--foreground`, `--port`, `--disk`, `--persist` | Local | Start a local instance (background by default) |
| [`helix stop`](/cli/command-reference/stop) | | | Local | Stop a background local instance |
| [`helix restart`](/cli/command-reference/restart) | | | Local | Restart a background local instance |
| [`helix status`](/cli/command-reference/status) | | | Local, Helix Cloud | Show instance status |
| [`helix logs`](/cli/command-reference/logs) | | `-f`/`--follow`, `-r`/`--range`, `--start`, `--end` | Local, Helix Cloud | View instance logs |
| [`helix query`](/cli/command-reference/query) | | `-f`/`--file`, `--json`, `-e`/`--ts`, `--ts-file`, `--warm`, `--host`, `--port`, `--compact` | Local, Helix Cloud | Send a dynamic query (JSON or TypeScript DSL) to `POST /v1/query` |
| [`helix auth`](/cli/command-reference/auth) | `login`, `logout`, `create-key` | | Helix Cloud | Manage Helix Cloud authentication |
| [`helix workspace`](/cli/command-reference/workspace) | `list`, `show`, `switch` | `--format`, `--id` | Helix Cloud | Manage active workspace selection |
| [`helix project`](/cli/command-reference/project) | `list`, `show`, `switch` | `--format`, `--id`, `--workspace-id` | Helix Cloud | Manage linked project selection |
| [`helix cluster`](/cli/command-reference/cluster) | `list`, `indexes` | `--format`, `--workspace-id`, `--project-id`, `--cluster-id` | Helix Cloud | List Helix Cloud clusters and their indexes |
| [`helix push`](/cli/command-reference/push) | | | Helix Cloud | Deploy a Helix Cloud instance to Helix Cloud |
| [`helix sync`](/cli/command-reference/sync) | | `--dry-run`, `-y`/`--yes` | Helix Cloud | Refresh Helix Cloud instance metadata in `helix.toml` |
| [`helix prune`](/cli/command-reference/prune) | | `-a`/`--all`, `-y`/`--yes` | Local | Remove Helix-owned local containers, volumes, and workspaces |
| [`helix delete`](/cli/command-reference/delete) | | `-y`/`--yes` | Local, Helix Cloud | Delete an instance from `helix.toml` and local state |
| [`helix skills`](/cli/command-reference/skills) | `install`, `update`, `list` | `--project` | — | Install, update, and list the Helix agent skills |
| [`helix metrics`](/cli/command-reference/metrics) | `full`, `basic`, `off`, `status` | | Local, Helix Cloud | Configure CLI telemetry |
| [`helix update`](/cli/command-reference/update) | | `--force`, `--v1` | — | Update the CLI (and refresh installed skills) to the latest version |
| [`helix feedback`](/cli/command-reference/feedback) | | | — | Send feedback to the Helix team |
`helix config` is retained as a hidden compatibility alias. Use [`helix workspace`](/cli/command-reference/workspace), [`helix project`](/cli/command-reference/project), and [`helix cluster`](/cli/command-reference/cluster) directly — they're the canonical commands.
## Next Steps
The local init/run/query loop
Authenticate, link a project, and query a Helix Cloud cluster