layered-soul/memories/curated/project-structure.md
Hermes & Sam aa6386518b reframe: dual-OS survivability — Docker + FreeBSD jails
- SOUL.md: rewritten identity — Linux/Docker for reach, FreeBSD/jails
  for resilience. A vulnerability that kills one OS won't kill the other.
- AGENTS.md: agent matrix now includes isolation column (Docker/Bastille)
- memories/curated/project-structure.md: dual-OS strategy table
- verify_facts_probe.py: proper Docker detection (socket check, daemon status)

We are not betting on one OS. We are betting that catastrophic events
won't hit both platforms simultaneously.
2026-06-17 12:21:00 +02:00

2.2 KiB

Clawdie Project Structure

Clawdie is a dual-OS agent runtime designed for survivability — Linux+Docker for reach, FreeBSD+jails (Bastille) for resilience.

Core repos

Repo Language Purpose
colibri Rust (12+ crates) Cross-platform control plane: daemon, task board, skills catalog, store, MCP bridge
clawdie-ai Docs/config Agent runtime, control plane channels, handoff docs, session archives
clawdie-iso Shell/BSD FreeBSD ISO builder, firstboot wizard, installer, ZFS layout
hermes-bsd Python MIT-licensed FreeBSD Hermes patches (public)
hermes-soul Backup Hermes-native runtime backup (private)
layered-soul Identity Cross-harness portable identity (public)

Dual-OS strategy

Platform Container Strengths Safeguards against
Linux (debby, domedog) Docker Instant ecosystem access, any tool/language FreeBSD/jails catch Linux-specific exploits (glibc, systemd, kernel)
FreeBSD (OSA) Bastille jails ZFS integrity, different TCP stack, jail isolation Linux/Docker catches FreeBSD-specific bugs

If Docker goes down, OSA keeps running. If a FreeBSD jail escape emerges, debby keeps orchestrating.

Key binaries (colibri workspace)

  • colibri-daemon — always-on socket server, session/agent lifecycle, jail spawner
  • colibri — CLI client + probe binaries
  • colibri-glasspane-tui — ratatui live dashboard
  • clawdie — host installer/deployer (ZFS + service)

Development rules

  • Linux agents (debby, domedog): build + test + clippy, push to Forgejo
  • FreeBSD agent (osa): validate on real FreeBSD 15, run cargo test on bare metal
  • Rust Tier-2 target: x86_64-unknown-freebsd, TLS via rustls (no openssl-sys)
  • Zig 0.15.2 at ~/.local/bin/zig (required for herdr builds)

Docker infrastructure

Docker 29.5+ on Linux hosts. Containers for Hermes gateway, Zot RPC, Vaultwarden, Forgejo. Docker Desktop socket at ~/.docker/desktop/docker.sock or system socket at /var/run/docker.sock. Probe with verify_facts_probe.py --jails-containers.

Herdr

Terminal workspace manager at ~/ai/herdr (v0.6.2, local patches). Binary at ~/ai/herdr/target/release/herdr.