Skip to main content

Install

1

Install Node.js

If you don’t have Node.js installed yet, download it here.
2

Install with npm

Run the following command in your terminal:
npm install -g @usezombie/zombiectl
Use npx to run without a global install:
npx @usezombie/zombiectl --help

Agent Skills

The usezombie-install-platform-ops skill is the guided install UX driven from a host agent (Claude Code, Amp, Codex CLI, OpenCode). Add the skills with one command:
npx skills add usezombie/skills
This symlinks the /usezombie-* slash commands from the public usezombie/skills repo into every supported host’s skill directory it detects on your machine — invoke /usezombie-install-platform-ops in your agent and you’re set. Pass --host=<claude|amp|codex|opencode> to target a single host instead of every detected one.
No global install? curl -fsSL https://usezombie.sh | bash installs zombiectl and the skill together in one command (requires Node — it runs npm under the hood). Run curl -fsSL https://usezombie.sh without | bash to read it first.
The skill drives zombiectl install --from, zombiectl credential, zombiectl steer, zombiectl logs, and the doctor preflight under the hood. See Quickstart for the end-to-end flow.

Verify installation

zombiectl --version

Check connectivity

Run the built-in diagnostics command to verify API connectivity, auth status, and local configuration:
zombiectl doctor
doctor runs three checks and exits non-zero if any fails. It does not require authentication and never short-circuits — every check runs and reports:
CheckVerifies
server_reachableGET /healthz against the configured API URL returns { "status": "ok" } within 5s.
workspace_selectedThe local config has a current_workspace_id. Auto-populated by zombiectl login from your signup-provisioned default workspace; can also be set or replaced by zombiectl workspace add / workspace use.
workspace_binding_validThe resolved auth token can read the selected workspace’s agents — i.e. it is bound to the right tenant. Reports a failed check (rather than aborting) when no token is present.
Pass --json for the structured { ok, api_url, checks: [...] } envelope. Run it before any install — host-agent skills depend on this preflight. For the tenant’s inference posture and free-trial window, use zombiectl tenant provider show.