From e6723f8617fd7ac010c68b5f29cde5917c012a51 Mon Sep 17 00:00:00 2001 From: Roone Date: Sat, 26 Sep 2026 16:42:21 -0600 Subject: [PATCH 1/2] Name the harness as a userspace whose user is a model Co-Authored-By: Claude Opus 5.5 (1M context) --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 99470b7..79d9d6c 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ cead (Irish: permission; "kyad")

-cead is an agent harness built as a microVM. +cead is an agent harness built as a microVM: a userspace whose user is a model. The model gets a Linux machine of its own and a shell to drive it: the kernel permits each command, and eBPF witnesses it. ## What cead is From 11a7c936fb971e993fe9c0401a0ded3cd1607b4f Mon Sep 17 00:00:00 2001 From: Roone Date: Sat, 26 Sep 2026 17:13:29 -0600 Subject: [PATCH 2/2] Name the three ways work fans out, by who spawns and when Co-Authored-By: Claude Opus 5.5 (1M context) --- README.md | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 79d9d6c..684a576 100644 --- a/README.md +++ b/README.md @@ -108,9 +108,16 @@ The machine runs wherever the cead CLI runs: a laptop or a cloud VM with a hyper The model runs wherever the declaration's endpoint is: a hosted API or a local server. The CLI drives everything below: it reads the declaration, boots, runs, snapshots, forks, and reads the log. -- The machine is the unit of scale. - A snapshot captures a machine and all its state; a fork boots another machine from it, the way a git worktree forks a checkout. - Kubernetes can schedule machines as pods; Firecracker was built for this shape of workload. +The machine is the unit of scale. +Work fans out three ways, told apart by who spawns and when: + +| Use | Who spawns | When | Mechanism | +|---|---|---|---| +| evals | operator | before the run | scale-out: N machines from one declaration | +| reinforcement learning | operator or trainer | mid-run, at a chosen state | fork: K machines from one snapshot, the way a git worktree forks a checkout | +| long or autonomous tasks | the model | whenever it decides | `rlm`: a sub-agent process inside the machine | + +- Kubernetes can schedule machines as pods; Firecracker was built for this shape of workload. - The long-term direction is one box: model, inference engine, kernel and cead. ### Identity