# Clawdie Project Structure

Clawdie is a FreeBSD-based edge computing and agent runtime platform. The project spans multiple repositories, each with a distinct role.

## 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-soul`  | Backup           | Hermes-native runtime backup (private)                                              |
| `layered-soul` | Identity         | Cross-harness portable identity (this repo)                                         |

## 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)

## Herdr

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