helix-cli

Installation
SKILL.md

Helix CLI

A runtime and control-plane client: no .hx compile, query-bundle deploy, source push or gateway sync. All commands and flags: REFERENCE.md. End-to-end sessions: EXAMPLES.md.

Run it as an agent

  • Pass global --json on every command: never prompts, compact result JSON on stdout, failures on stderr as {"error": {"message", "context"?, "caused_by"?, "hint"?, "candidates"?: [{"id", "name"}]}}. Runtime failure exits 1; usage error (bad flag/argument) exits 2.
  • Under --json or without a terminal (stdin or stderr not a TTY), a picker fails and lists candidates: ask the user, then re-run with one (--workspace, --project, --database, an instance name, or tenant:<id> / cluster:<id>). Never guess.
  • delete, prune, project delete, database delete, database key revoke and service-credential revoke need --yes without a terminal. --yes is per command, not global; pass it only after the user confirmed that exact action.
  • --quiet (errors and final result only) and -v/--verbose (timings) don't combine with --json.
  • helix chef, helix skills install and helix skills list are interactive and refuse --json.
Installs
270
Repository
helixdb/skills
GitHub Stars
5
First Seen
Jun 6, 2026