clawdie/layered-soul
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: expand agent matrix — 5 agents across 3 hosts, Hermes-FreeBSD integration plan

Browse source 
- Agent roster: add Autolycus (Hermes fork on FreeBSD 15/OSA)
- AGENTS.md: full 5-agent matrix with harness/OS/role
- New doc: CLAIRE-FREEBSD-HERMES-INTEGRATION.md — phased plan
- Added hermes-freebsd to private sources list
This commit is contained in:
Hermes & Sam 2026-06-14 03:09:17 +02:00
parent a022b0882b
commit 9c332b1b78
3 changed files with 127 additions and 10 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

14
AGENTS.md
View file

@ -7,7 +7,8 @@
- Public examples may reference private source repositories by URL/name, but must not quote or copy their private contents.
- Use `scripts/layered_soul.py validate .` before committing structural changes.
- When adapting for Colibri: reviewed skills map to `system_skills`, curated memory maps to `system_brain`, converted task manifests map to `system_ops`.
- When adapting for Hermes: load as profile context (SOUL.md + USER.md + IDENTITY.md). Hermes-native config and cron stay in `hermes-soul`.
- When adapting for Hermes (upstream, Linux): load as profile context (SOUL.md + USER.md + IDENTITY.md). Hermes-native config and cron stay in `hermes-soul`.
- When adapting for Autolycus (Hermes fork, FreeBSD): same profile-context load; FreeBSD-specific gaps (voice, clipboard) are known and tracked in `docs/CLAIRE-FREEBSD-HERMES-INTEGRATION.md`.
- When adapting for Pi/Codex/Claude Code/Zot: render the prompt bundle (`render-prompt`) and inject as task-scoped context. Durable findings flow back through reviewed commits.
## Active infrastructure
@ -17,9 +18,20 @@
- Tailscale: debby=100.66.193.10, domedog=100.103.255.41, osa=100.72.229.63
- Commit identity: `hello@clawdie.si` for all project commits
## Agent matrix (5 agents across 3 hosts)
| Agent | Host | Harness | OS | Role |
|-------|------|---------|----|------|
| Hermes | debby | Hermes Agent (upstream) | Debian 13 | Orchestrator, soul backup |
| Zot | debby | Zot RPC | Debian 13 | Coding, media workflows |
| Claude | domedog | Claude Code | Linux | Verification, review |
| Codex | osa | Codex CLI | FreeBSD 15 | ISO builds, validation |
| Autolycus | osa | Hermes Agent (fork) | FreeBSD 15 | Native FreeBSD Hermes |
## Private sources
- `hermes-soul`: git@code.smilepowered.org:clawdie/hermes-soul.git (private, operator access only)
- `hermes-freebsd`: git@code.smilepowered.org:clawdie/hermes-freebsd.git (private, Hermes fork for FreeBSD)
- `clawdie-ai`: git@code.smilepowered.org:clawdie/clawdie-ai.git (private)
- `clawdie-iso`: git@code.smilepowered.org:clawdie/clawdie-iso.git (private)

89
docs/CLAIRE-FREEBSD-HERMES-INTEGRATION.md Normal file
View file

@ -0,0 +1,89 @@
# Clawdie + Hermes-FreeBSD Integration Plan
## What we have
**hermes-freebsd** (code.smilepowered.org/clawdie/hermes-freebsd): An LGPL v2.1 fork
of Hermes Agent by Technetia Inc (branded as "Autolycus"), targeting FreeBSD natively.
8,526 files, 532MB. Audited April 2026 against FreeBSD 15.0-RELEASE-p5.
**Key facts:**
- Runs on FreeBSD without emulation or containers
- CLI, Telegram gateway, TUI all functional on FreeBSD
- `scripts/install-freebsd.sh` provides native installation
- Core agent logic is platform-agnostic Python — same codebase as upstream Hermes
- Gaps: no FreeBSD wheels for faster-whisper (voice), no clipboard implementation
## Why this matters for Clawdie
Currently OSA (FreeBSD 15 host) runs Codex CLI for ISO builds and cargo validation.
It has no Hermes instance — all orchestration happens on debby (Linux). Adding
Autolycus to OSA gives us:
| Capability | Before | After |
|-----------|--------|-------|
| Hermes on FreeBSD | ❌ None | ✅ Native |
| ISO-side agent | ❌ Codex only | ✅ Hermes + Codex |
| layered-soul on FreeBSD | ❌ No | ✅ Via adapters/hermes.md |
| Headroom on FreeBSD | ❌ No path | ✅ Python works natively |
| Colibri + Hermes co-host | ❌ Linux only | ✅ Both on FreeBSD |
| Telegram gateway on OSA | ❌ No | ✅ Direct from FreeBSD |
## Phased integration
### Phase 1: Standalone test (OSA side)
1. Install Autolycus on OSA via `scripts/install-freebsd.sh`
2. Configure with a provider (DeepSeek or OpenRouter)
3. Verify basic functionality: terminal execution, file ops, web search
4. Test Telegram gateway on OSA
5. Document what works and what doesn't on FreeBSD 15
### Phase 2: Identity injection
1. Clone `layered-soul` on OSA
2. Load SOUL.md, USER.md, IDENTITY.md, AGENTS.md as profile context
3. Verify Autolycus operates with the same identity as Hermes on debby
4. Test: can Autolycus on OSA read the same skills as Hermes on debby?
### Phase 3: Colibri co-hosting
1. Both Autolycus and colibri-daemon run on OSA simultaneously
2. Autolycus can issue socket commands to the daemon (`cmd_status`, etc.)
3. Headroom sidecar runs on OSA (Python works natively)
4. Test: ISO build triggered by Autolycus, results reported via Telegram
### Phase 4: ISO shipping
1. Add Autolycus to Clawdie ISO package list
2. Pre-configure with layered-soul identity
3. Install as a FreeBSD service alongside colibri-daemon
4. First-boot wizard optionally sets up Hermes
## Agent matrix (expanded)
| Agent | Host | Harness | OS | Model | Role |
|-------|------|---------|----|-------|------|
| Hermes | debby | Hermes Agent (upstream) | Debian 13 | DeepSeek v4 | Orchestrator, soul backup |
| Zot | debby | Zot RPC | Debian 13 | GLM-5.1 | Coding, media |
| Claude | domedog | Claude Code | Linux | Claude | Verification, review |
| Codex | osa | Codex CLI | FreeBSD 15 | GPT | ISO builds, validation |
| **Autolycus** | **osa** | **Hermes Agent (fork)** | **FreeBSD 15** | **TBD** | **Native FreeBSD agent** |
## Gaps to close (from FreeBSD audit)
| Gap | Severity | Fix |
|-----|----------|-----|
| faster-whisper wheels | Medium | Build from source, or skip voice on FreeBSD |
| Clipboard support | Low | Implement xclip/xsel equivalent for FreeBSD |
| Docker/Singularity backends | Low | Skip — Colibri provides jail-based isolation |
| Platform detection in setup.py | Medium | Add FreeBSD branches (upstreamable) |
## Files to touch
| File | Change |
|------|--------|
| `layered-soul/memories/curated/agent-roster.md` | Add Autolycus row |
| `layered-soul/AGENTS.md` | Add Autolycus to agent references |
| `layered-soul/docs/PLAN-CONFIGURE-PRIVATE-REPO.md` | Add Phase 5: FreeBSD agent |
| `clawdie-ai/docs/` (or handoff) | Agent matrix expansion note |
| `colibri/docs/AGENTS.md` | Note FreeBSD-side Hermes availability |

34
memories/curated/agent-roster.md
View file

@ -1,19 +1,35 @@
# Agent Roster
| Agent | Home Host | Harness | Model | Role |
| ------ | --------- | ------------ | -------- | ------------------------------------------- |
| Hermes | debby | Hermes Agent | DeepSeek | Orchestrator, primary dev agent |
| Zot | debby | Zot RPC | GLM-5.1 | Coding specialist, media workflows |
| Claude | domedog | Claude Code | Claude | Independent verification, secondary builder |
| Codex | osa | Codex CLI | GPT | FreeBSD 15 validation, ISO builds |
## Active agents
## Multi-agent group
| Agent | Home Host | Harness | Model | Role |
|-------|----------|---------|-------|------|
| Hermes | debby (Debian 13) | Hermes Agent | DeepSeek v4 | Orchestrator, primary dev agent, soul backup |
| Zot | debby (Debian 13) | Zot RPC | GLM-5.1 | Coding specialist, media workflows |
| Claude | domedog (Linux) | Claude Code | Claude | Independent verification, secondary builder, reviewer |
| Codex | osa (FreeBSD 15) | Codex CLI | GPT | FreeBSD 15 validation, ISO builds, hardware proofs |
| Autolycus | osa (FreeBSD 15) | Hermes Agent (fork) | TBD | Native FreeBSD Hermes instance, ISO-side agent |
"My Debby" Telegram group: @hermes_samob_bot + @zot_samob_bot. Hermes orchestrates, delegates coding/media to Zot via structured delegation.
## Multi-agent groups
| Group | Platform | Members | Purpose |
|-------|----------|---------|---------|
| "My Debby" | Telegram | @hermes_samob_bot + @zot_samob_bot | Orchestration + coding delegation |
| FreeBSD side | OSA host | Codex + Autolycus | ISO builds, validation, native FreeBSD ops |
## Harness matrix
| Harness | Hosts | Native OS | Capabilities |
|---------|-------|-----------|-------------|
| Hermes Agent (upstream) | debby | Linux | Full agent, skills, cron, Telegram gateway, voice |
| Hermes Agent (Autolycus fork) | osa | FreeBSD 15 | Fork targeting FreeBSD, LGPL v2.1, PTY/local terminal |
| Zot RPC | debby | Linux | Structured delegation, GLM-5.1 inference |
| Claude Code | domedog | Linux | Verification, code review, document review |
| Codex CLI | osa | FreeBSD 15 | ISO builds, cargo test, hardware validation |
## Secrets
All agent API keys live in Vaultwarden at vault.smilepowered.org (BW_SERVER). Bootstrap credentials (BW_CLIENTID, BW_CLIENTSECRET, BW_PASSWORD) are the only secrets in `.env` files — everything else is fetched from the vault at runtime.
All agent API keys live in Vaultwarden at vault.smilepowered.org. Bootstrap credentials (BW_CLIENTID, BW_CLIENTSECRET, BW_PASSWORD) are the only secrets in `.env` files — everything else is fetched from the vault at runtime.
## Verification