Getting Started on processkit

Installing

Mon, 01 Jan 0001 00:00:00 +0000

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:

Install and Use the v1 Alpha

Mon, 01 Jan 0001 00:00:00 +0000

This tutorial installs the exact v1.0.0-alpha.5 release into a new project. Linux and macOS on x86_64 and arm64 are supported.

1. Check prerequisites

uname -m
python3 --version
uv --version
git --version
jq --version

Python 3.10 or newer, uv, Git, curl, tar, a SHA-256 utility, openssl, and jq are required.

2. Download the exact release

mkdir -p "$PWD/.processkit-download/v1.0.0-alpha.5"
cd "$PWD/.processkit-download/v1.0.0-alpha.5"

release_url="https://github.com/projectious-work/processkit/releases/download/v1.0.0-alpha.5"
for asset in \
 processkit-v1.0.0-alpha.5.tar.gz \
 processkit-v1.0.0-alpha.5.tar.gz.sha256 \
 processkit-v1.0.0-alpha.5.release.json \
 processkit-v1.0.0-alpha.5.release.sig \
 processkit-v1.0.0-alpha.5-public.pem
do
 curl -fL "$release_url/$asset" -o "$asset"
done

The release is exact-pinned. Do not replace the tag with latest.

Your First Entity

Mon, 01 Jan 0001 00:00:00 +0000

Create the first WorkItem through processkit’s MCP tools. Do not hand-edit canonical entity files: the management tool validates the schema, applies the storage policy, and writes the audit event as one governed operation.

Prerequisites

Complete the v1 alpha tutorial .
Start a new harness session after the installer writes its managed MCP projection.
Confirm the processkit-gateway tools are visible.

Create a WorkItem

Ask your MCP-capable agent:

Create a medium-priority task WorkItem titled “Evaluate processkit v1 alpha” with acceptance criteria to verify installation, record one decision, and test an update plan.