32 lines
1.4 KiB
Markdown
32 lines
1.4 KiB
Markdown
|
# 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`.
|