Skip to content
Kindgi

CLI

The kindgi command-line interface (@kindgi/cli). Generated from the CLI's own command definitions, so it matches this version.

Commands

Section titled “Commands”
  • kindgi auth: Manage local auth configuration.
  • kindgi init: Scaffold a new Kindgi pack repo, or add Kindgi to an existing Node.js project (auto-detected when a package.json is present and no pack-name is given).
  • kindgi dev: Run the Kindgi runtime as a container + hot-reload the pack under cwd.
  • kindgi build: Bundle + build + sign a pack image. Emits deploy-envelope.json for kindgi deploy. --local builds the image with this machine's Docker instead: no build service, no signing; with --push, it pushes the image, signs it, and writes the envelope.
  • kindgi deploy: Deploy a signed pack image to Kindgi. Reads deploy-envelope.json (or runs kindgi build inline) + POSTs to /v1/deployments.
  • kindgi test: Run the pack's tests via vitest. Ergonomic wrapper over vitest run.
  • kindgi env: Manage per-environment values that resolve into needs.env at deploy time.
  • kindgi secrets: Manage per-environment secrets via the /v1/secrets/* wire.
  • kindgi key: Manage the tenant's local Ed25519 signing keys under ~/.kindgi/keys/.
  • kindgi mcp: Manage MCP server entries in .mcp.json (add / list / remove / presets).
  • kindgi mcp-launch: Spawn an MCP server subprocess with secrets injected from Kindgi. Invoked by MCP clients via .mcp.json — not for direct use.
  • kindgi runs: Manage kernel runs — the single execution primitive.
  • kindgi agents: Manage agent registrations.
  • kindgi tools: Manage tool registrations.
  • kindgi guardrails: Manage guardrail registrations.
  • kindgi approvals: Review HITL approvals.
  • kindgi reviewers: Manage HITL reviewers.
  • kindgi providers: Manage model providers.
  • kindgi adapters: Manage adapter lifecycle (prepare / warmup). Read-side lives on kindgi providers.
  • kindgi skills: Manage the pack's .claude/skills/ directory.
  • kindgi feedback: Report framework friction Claude Code diagnosed — bugs, wire schema gaps, misleading errors, UX cliffs.
  • kindgi health: Ping the API server (GET /health).
  • kindgi version: Print CLI + SDK versions (and API version if reachable).

Global flags

Section titled “Global flags”

Every command takes these:

  • --help (-h): Show help.
  • --json: Output pretty-printed JSON (the default).
  • --quiet: Print nothing: the exit code alone reports the result.
  • --raw: Output compact, one-line JSON.
  • --table: Output a table, for commands that list.
  • --token <value>: The API token. Overrides KINDGI_API_TOKEN and the config files.
  • --url <value>: The Kindgi API's URL. Overrides KINDGI_API_URL and the config files.
  • --verbose (-v): Show more detail when a command fails.
  • --version: Print the CLI's version.