okf
source_of_truth last_verified verified_by review_scope platform_notes build.sh 2026-10-31 pi@debby Product wording for the 0.15.1 release; no new runtime acceptance. FreeBSD: builds the live image; Linux and FreeBSD: write the same USB artifact.

Clawdie ISO

From a bootable USB drive to your autonomous AI workstation.

Clawdie builds a live FreeBSD 15.1-RELEASE ZFS workstation, and the same artifact can be installed to disk. It stages a signed first-party package matrix, two agent harnesses, and local semantic memory — all reachable offline from the image.

What the 0.15.1 image contains

• FreeBSD 15.1-RELEASE, amd64, ZFS live root plus an installable disk layout.

• XFCE live desktop with a browser and Tailscale available immediately.

• Signed Poudriere package matrix (first-party, built for 15.1):

  Package	Version	Role
  colibri	0.15.1	Go + Rust control plane: daemon, tasks, hydrate, health, MCP
  herdr	0.9.5	Pane and agent-workspace orchestrator
  oxigraph	0.4.9	sova — exact-state RDF projection service
  openviking	0.4.19	Local semantic memory (ov CLI + server)
  zot	published build	Agent harness

• Two harnesses, one memory contract: Pi loads its OpenViking extension automatically (recall, profile injection, turn capture, session commit); Zot exposes the same service as six explicit tools. Both read /home/clawdie/.openviking/ovcli.conf, which the image stages as a secret-free template at mode 0600.

• Reviewed skills at /usr/local/share/colibri/skills/ (openviking, sova), symlinked into /home/clawdie/.agents/skills/. The sova skill is deliberately dormant: agents never receive direct SPARQL or graph access.

• Offline package bundle active at live boot, so pkg install resolves without a network.

The retained build evidence for the 15.1 five-package matrix and the live OpenViking end-to-end check is docs/evidence/poudriere-2026-10-31-15.1-matrix/README.md. Package and image claims remain the target matrix until each receipt is independently reproduced.

Build

cp build.cfg.example build.cfg   # if starting fresh; edit defaults
./build.sh                       # writes tmp/output/clawdie-<codename>-0.15.1.img.xz

Defaults live in build.cfg (authoritative): FREEBSD_VERSION=15.1-RELEASE, ISO_VERSION=0.15.1. FEATURE_COLIBRI=NO is the default minimal image; FEATURE_COLIBRI=YES stages the Colibri control plane and its rc.d service.

Build hosts: FreeBSD 15.1 (primary: valhala) or Linux for artifact writing. The image build, package staging, and validation gates are documented in BUILD.md and TESTING.md.

First boot

• Live path: boots to the XFCE desktop; the operator account is clawdie.
• Disk path: the same media installs a ZFS workstation; see FIRSTBOOT.md for the boot chain and acceptance gate.
• Memory clients: scripts/stage-memory-clients-iso.sh stages the skills, ovcli.conf, the Pi extension, and the interactive/Colibri Zot extensions. A sealed seed may merge OPENVIKING_URL/OPENVIKING_API_KEY at first boot.

Verification

./scripts/ci-checks.sh

The gate covers markdown formatting, link linting, date/OKF frontmatter, shell syntax, the Poudriere harness tests, the jail wrappers, the memory-client staging tests, and the first-party port contracts.

Repository layout

Path	Contents
build.sh, build.cfg	image build entry point and defaults
scripts/	build helpers, Poudriere harness, validation, tests
packaging/freebsd/ports/	first-party ports (sysutils/*, databases/oxigraph)
packages/	package lists and the Poudriere manifest
live/	live-image payloads (operator session, Pi/Zot extensions)
skills/	reviewed agent skills shipped into the image
firstboot/	first-boot orchestration
docs/	build and operations references

Third-party components keep their own licenses; colibri is BSD-3-Clause.