Installing

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

processkit is distributed as versioned GitHub releases. Each release contains a tarball with the shipped context/, .processkit/, and agent entrypoint files. You can install those files manually or let a managed environment tool do it.

Manual install

Download and unpack the release tarball:

curl -L \
 https://github.com/projectious-work/processkit/releases/download/v0.25.1/processkit-v0.25.1.tar.gz \
 -o processkit-v0.25.1.tar.gz
tar -xzf processkit-v0.25.1.tar.gz

Copy the shipped files into your project:

cp -a processkit-v0.25.1/context ./context
cp -a processkit-v0.25.1/.processkit ./.processkit
cp processkit-v0.25.1/AGENTS.md ./AGENTS.md

Then register the gateway with your harness. For stdio MCP:

Your First Entity

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

Create your first WorkItem and see how processkit’s entity format works.

Prerequisites

A project with processkit installed (see Installing ).
A package tier that includes workitem-management; minimal and higher tiers include it.

Creating a WorkItem by hand

Write a file at context/workitems/BACK-first-task.md:

---
apiVersion: processkit.projectious.work/v1
kind: WorkItem
metadata:
 id: BACK-first-task
 created: 2026-04-06T10:00:00Z
 labels:
 area: onboarding
spec:
 title: "Try out processkit"
 state: backlog
 type: task
 priority: medium
 description: "Walk through the processkit docs and create a few entities."
---

## Acceptance criteria

- [ ] Read the primitives overview
- [ ] Read the skills overview
- [ ] Create this first WorkItem
- [ ] Transition it to in-progress, then done

If your installer has a validation command, run it now. The file has the core apiVersion, kind, metadata.id, and spec fields expected by the WorkItem schema.

Getting Started on processkit

Installing

Manual install

Your First Entity

Prerequisites

Creating a WorkItem by hand