Skip to content
All releases
Current releaseReleased 2026-10-11

Phelix v1.1.0

The agent-native release. Phelix becomes a controlled execution layer for coding agents: a built-in MCP adapter, a fail-closed execution-authorization boundary with plan-bound approvals, durable agent execution sessions, and a versioned --json machine contract on every core command. An agent proposes what to deploy; Phelix decides whether this caller may execute that exact plan; a human decides who signs it off.

Release highlights

Controlled execution for agents

A built-in MCP adapter exposes read tools plus two-step plan create and apply to Claude Code, Codex, and any MCP client over local stdio, the same pipeline as the CLI.

Execution authorization

An optional, fail-closed boundary between a validated plan and the engine: plan-bound, approval-gated, off by default, and never degrading to allow-everything once configured.

Plan-based execution

Immutable, content-addressed plans: the thing that was planned is the thing that gets executed, or execution fails closed on a hash mismatch.

Plan-bound approvals

Approvals bind a plan's id and content hash, so a human signs off that exact plan. An agent can never approve its own action.

Agent execution sessions

Durable, auditable tracking of one unit of agent work across inspect, plan, apply, and verify, so an interrupted agent resumes by reading state. Tracking only: it executes nothing.

Machine contract (--json)

Every core command emits one versioned JSON envelope on stdout, with stable error codes, exit codes, and operation correlation for scripts and agents.

Install or upgrade

The installer selects the correct prebuilt binary and configures the Linux monitor service. Running it again upgrades an existing installation.

Terminal
curl -fsSL https://phelix.anophel.com/install.sh | bashphelix version

Compatibility

Areav1.1.0 support
HostLinux primary; Windows experimental
LanguagesGo and Rust
Agent clientsMCP over local stdio (Claude Code, Codex, any MCP client)
AuthorizationOff by default (legacy_local); opt-in enforced policy with plan-bound approvals
Machine output--json on every core command (schema_version 1, additive-only)
ContainersDocker; Docker Buildx for multi-arch manifests

Operational notes

What shipped

  • MCP adapter (phelix mcp serve --stdio)
  • Read + two-step mutation MCP tools (plan create / apply)
  • Agent-session MCP tools (create, checkpoint, complete, fail)
  • Immutable, content-addressed execution plans
  • plan create / show / list / apply
  • Execution authorization boundary (legacy_local / enforced)
  • Plan-bound, immutable approvals (authz approve / revoke / check / status)
  • Agent execution sessions with durable tracking and recovery
  • Versioned --json machine contract on every core command
  • Exit-code 2 / 3 split (invocation vs validation)
  • New authorization, session, canary, and OOM error codes
  • Request-key idempotency surfaced in the machine contract
  • Bounded, redacted --json logs (--lines, --since, --no-follow)

Continue with the v1.1.0 guide

Explore command details, deployment guarantees, and production operating practices.

Open documentation