Research · 2026-04-23

The appliance architecture: an OS whose init process is an agent

design-docagentic-os

Host/guest split, VSOCK-only communication, MCP servers as in-guest CLI tools, and a scriptable intelligence socket — the architecture that makes agent runs deterministic and containment structural.

Sandboxing an agent usually means wrapping a process. Agentic OS inverts the frame: give the agent an entire operating system — and isolate the operating system.

The guest is a from-scratch Linux image that boots in under 30 ms into agentd, the PID-1 supervisor: an epoll reactor around a pure-logic reconciler driving five state machines, with cgroup v2, namespaces, seccomp BPF, and Landlock enforcing the interior walls. The agent harness runs the plan-act-observe loop as a supervised child. There is no network stack worth escaping to — zero egress is a property of the image, not a firewall rule.

The host runs the sandbox: QEMU or Firecracker lifecycle, virtio-fs mounts, and the VSOCK bridge that is the guest's only window. Two things cross it. MCP servers on the host are materialized as ordinary CLI tools inside the guest, so the agent uses fetch-page like any Unix command while the host applies rate limits and audit at the boundary. And the LLM itself arrives via the intelligence socket — either a live provider or a scripted mock, which is the architecture's quiet superpower: a recorded intelligence script makes an agent run deterministic and replayable, byte for byte.

The trust chain closes the loop: Ed25519-signed boot manifests and a UEFI Secure Boot chain mean the artifact that boots is the artifact you built. The same image runs in a VM on your desk or from a USB stick on an ARM single-board computer — the robot brain and the CI sandbox are one build target.

The design doc's thesis, compressed: when the agent is PID 1, containment stops being a policy and becomes the platform.

Canonical: tsok-org monorepo · docs/agentic-os/01-architecture.md