Reference
Command reference
A compact map of the Phelix v1.1.0 command surface.
Every command below also supports interactive auto-prompting: run it without a required argument and Phelix asks for it (when stdin is a terminal). See Interactive wizard.
Application commands
| Command | Description |
|---|---|
| phelix build <NAME> | Compile, version, and start a Go or Rust project. |
| phelix rebuild <NAME> | Rebuild an existing app with classic or zero-downtime deployment. |
| phelix start [<NAME>] | Start one app, or every app when no name is supplied. --ensure builds if missing. |
| phelix stop <NAME> | Stop a running app. |
| phelix restart <NAME> | Restart an app. |
| phelix status <NAME> | Show PID, uptime, RAM/CPU, watching, version, deploy mode, and proxy routing. |
| phelix list | Table of every managed app with version, status, watching, deploy, and proxy columns. |
| phelix log [<NAME>] | Tail app logs (last 10 lines + live stream); no arg shows Phelix's own logs. |
| phelix remove <NAME> | Stop and remove an app from management. |
| phelix watch <NAME> | Enable (default) or disable backend monitoring for one app (--disable). |
Deployment & delivery
| Command | Description |
|---|---|
| phelix rebuild <NAME> | Rebuild an app; classic, zero-downtime (--blue-green / --replicas), or verified canary / progressive rollouts (--canary, --strategy) |
| phelix rollback <NAME> | Restore a previous version; --to targets a version or tag, --dry-run previews the plan, --reason and --verify record and observe it |
| phelix rollback history <NAME> | Recorded rollback outcomes for one app, newest first (--limit N) |
| phelix proxy | Operate the zero-downtime reverse proxy (start, status, stop, --foreground) |
| phelix dockerize <NAME> | Build and optionally publish Docker images; compose scaffolding |
| phelix matrix | Inspect and manage matrix runs: list, show, status, retry, init (see Matrix runs) |
| phelix deploy unlock | Interactive deploy unlock (also offered in the wizard) |
| phelix webhook | Run the foreground Git push webhook server (--host, --port); deploy exact pushed commits |
| phelix webhook status <app> | Inspect in-flight deployment jobs offline and read-only (--json) |
| phelix webhook history <app> | Inspect recent finished deployment jobs offline and read-only (--limit N) |
Configuration & diagnostics
| Command | Description |
|---|---|
| phelix init | Create phelix.yaml for the current project (--name, --port, --runtime, --yes) |
| phelix doctor | Diagnose project compatibility (PORT usage, config, toolchain) |
| phelix build-report <NAME> | Read-only inspection of stored build reports (--limit N) |
Security & monitoring
| Command | Description |
|---|---|
| phelix env | Manage encrypted app variables (set, get, list, unset, check) |
| phelix health | Configure and inspect health checks (set, add, list, remove, status) |
| phelix auth | Optional dashboard authentication (login, status, logout) |
| phelix monitor | Run the long-lived gRPC fleet monitoring daemon |
| phelix watch <NAME> | Opt one app in to (or out of) backend monitoring (--disable); disabled by default |
| phelix wizard | Guided interactive menu for every task |
Automation & agents
New in v1.1.0: a plan-based execution path and the surfaces that make Phelix safe to hand to a coding agent. Every command below also accepts --json and emits the versioned machine contract envelope on stdout.
| Command | Description |
|---|---|
| phelix plan create <rebuild|rollback> | Create an immutable, content-addressed execution plan - describes the mutation, never executes |
| phelix plan show / list | Inspect a plan's content and fresh applicability, or list recent plans |
| phelix plan apply <plan-id> | Execute a previously created plan through the full validation and authorization pipeline |
| phelix authz | Inspect and manage execution authorization (status, check, approve, revoke) - plan-bound approvals |
| phelix session | Track one unit of agent work (create, show, list, checkpoint, complete, fail, cancel); tracking only |
| phelix mcp serve --stdio | Run the local MCP server for coding agents such as Claude Code and Codex |
See Execution authorization, MCP adapter, and Agent execution sessions for the full model.
Utility
phelix version [--short | --verbose]phelix update [--check] # update the Phelix binary to the latest releasephelix --helpEvery command exits with a stable, category-scoped exit code so automation can branch on failure mode. See Exit codes for the full mapping and the machine contract for the --json envelope that carries the same code in error.exit_code.