Helix CLI

Use the CLI as a runtime and control-plane client. It does not compile .hx files, deploy query bundles, push source, or sync gateway metadata.

Choose the execution boundary

• Local [local.<name>]: Docker/Podman, auth-disabled local /v2/query.
• Cloud [enterprise.<name>]: stable tenant:<id> or dedicated cluster:<id> linkage.
• Cloud query and shell: backend query broker, never a direct gateway request.
• Direct application gateway access: outside CLI authentication; explicitly created database key.

Local image and storage

Use ghcr.io/helixdb/helixdb:v0.0.5. Set tag = "v0.0.5" in the relevant [local.<name>] block before starting an existing project or using a CLI with an older default. The server exposes /healthz, /readyz, and /v2/query on port 8080; the CLI defaults to host port 6969 and waits for /healthz.