Installing

v1 alpha

v1.0.0-alpha.5 is installed with the native Rust lifecycle CLI from an explicitly downloaded, signed release. The alpha does not yet have an online version resolver or one-command bootstrap installer.

Use the complete v1 alpha installation and first-project tutorial . It verifies the signed envelope, checks both artifact digests, previews the plan, installs a selected profile, verifies managed state, and connects the Python MCP gateway.

The current command shape is:

processkit plan \
  --root /path/to/project \
  --distribution /path/to/processkit-v1.0.0-alpha.5 \
  --profile managed \
  --harness codex

processkit install \
  --root /path/to/project \
  --distribution /path/to/processkit-v1.0.0-alpha.5 \
  --profile managed \
  --harness codex \
  --yes

Do not copy the v1 payload by hand. The CLI supplies transaction, ownership, recovery, and conservative uninstall evidence that manual copying cannot.

Stable v0 and managed aibox projects

Existing v0 projects remain supported and should stay pinned to their current stable version until the v1 migration path is complete. aibox remains an optional downstream installer and integrator; it is not required to build, test, or run processkit.

See v0 compatibility and aibox integration before changing an existing project.

After installation

Python and uv remain runtime prerequisites for MCP:

uv run \
  context/skills/processkit/processkit-gateway/mcp/server.py \
  serve --transport stdio

Use MCP tools for entity writes. They validate schemas and transitions and produce the required audit events.