Preview This is the v1.0 preview line. It documents a rebuild that is still in alpha — schemas, tool names, and package contents change without notice, and nothing here is covered by a stability guarantee. For the released line, see the v0.x documentation.

Getting Started

Install a verified processkit release and use its MCP tools.

Choose the path that matches your release line:

  • v1 alpha: use the native CLI and signed local-release envelope. Start with the v1 alpha tutorial .
  • v0 stable: retain the supported v0 installer or managed aibox workflow. See Installing for the compatibility path.

What v1 installs

A v1 distribution contains visible, reviewable project content:

  • context/skills/ and the Python MCP servers shipped with those skills;
  • context/schemas/, generated contracts, and state machines;
  • .processkit/ profiles, installer contracts, and release metadata;
  • harness projections owned at individual managed keys; and
  • AGENTS.md, the provider-neutral agent entry point.

The installer records managed ownership in .processkit/state.json. New project entities and local overrides remain owned by the consuming project.

Runtime requirements

  • Linux ARM64 GNU for the published alpha.5 native executable.
  • Python 3.10 or newer and uv for the Python MCP runtime.
  • Git and an MCP-capable harness for the normal agent workflow.
  • curl, tar, and sha256sum for the tutorial.

Linux x86_64 and macOS native assets, a bootstrap installer, online release resolution, and native processkit doctor/processkit mcp commands are future work.

Learning path

  1. Complete the v1 alpha tutorial .
  2. Create your first entity through MCP.
  3. Review installer guarantees .
  4. Choose a package profile .
  5. Read the v1 implementation status .

Installing

Install and Use the v1 Alpha

Verify, install, and use processkit v1.0.0-alpha.5 step by step.

Your First Entity