Skip to main content
Reference
Bootstrap a first HelixDB app for a coding agent. helix chef installs agent context, scaffolds a local project, starts the local database, seeds starter data, writes a build prompt, and launches your coding agent to generate the app. Local only.

​
Usage

helix cook is an alias for helix chef. The command takes no flags — it is fully interactive (and falls back to sensible defaults when run without a TTY).
helix chef uses npx, so Node.js/npm must be on PATH for the skills and docs-MCP install, and it needs Docker or Podman running to start the local database. It is intended for local development inside a coding-agent environment.

​
Behavior

  1. Installs the Helix skills (npx skills add HelixDB/skills) and docs MCP.
  2. Initializes a local project (helix init local) with a dev instance on port 6969, then starts it in-memory.
  3. Writes HELIX_CHEF_PROMPT.md (your build intent, or a Personal CRM default) and, for the default build, starter query files under examples/ — then seeds the data.
  4. Detects an installed coding agent (Claude Code → OpenAI Codex → OpenCode → Cursor Agent), asks for a permission mode, and launches it against the build prompt.
  5. Opens the generated app at http://localhost:3000 once the agent’s frontend is running.
  • helix chef is a local workflow and does not require Cloud authentication. It neither uploads a project snapshot nor reads Cloud credentials. Use helix auth login separately only when you later run a Cloud command.
  • Without a TTY, setup runs with defaults and no agent is launched; point your own agent at HELIX_CHEF_PROMPT.md.
helix chef does not start a local dashboard — port 3000 is reserved for the Next.js app the agent builds.

​
Interactive mode

Running helix chef in a terminal prompts first for:
Leave this blank to use the default Personal CRM build. If you provide an app idea, it is written into HELIX_CHEF_PROMPT.md and used to drive the agent. Next, choose a setup mode: Before launching the agent, the CLI asks how much autonomy to give it: full autonomy, ask before each shell command, or don’t launch (print the prompt path instead).

​
Examples