CLI Reference

Global options:

• --help (or hexi help)
• --version (or hexi version)
• -v / -vv for runtime verbosity

hexi init

Initializes .hexi/ files in the current folder (or git root when detected).

Creates:

• .hexi/config.toml
• .hexi/local.toml
• .hexi/runlog.jsonl

hexi onboard

Interactive provider/model setup with optional local key storage.

hexi doctor

Diagnostics for:

• workspace mode (git repo or bootstrap mode),
• config presence,
• provider/model resolution,
• API key source (env, local, none).

Optional live probe:

hexi doctor --probe-model

hexi run "<task>"

Executes one model-planned step and exits.

Exit codes:

• 0 success
• 1 run failure
• 2 setup/config error

hexi apply --plan <file>

Executes a validated ActionPlan JSON directly (no model call).

Use for deterministic debugging and replay.

hexi plan-check --file <file>

Validates ActionPlan JSON and reports parse issues before execution.

hexi diff

Prints bounded git diff for current workspace.

hexi new

Scaffolds a project from built-in templates.

Main options:

• --template
• --name
• --path
• --git-init
• --interactive
• --force

hexi demo

Interactive demo flow that proposes or generates project ideas, scaffolds a template, and can run one customization step.