diff --git a/AGENTS.md b/AGENTS.md index 2ac5a02..37ef01c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -20,13 +20,13 @@ ## 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 | +| 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 diff --git a/docs/CLAIRE-FREEBSD-HERMES-INTEGRATION.md b/docs/CLAIRE-FREEBSD-HERMES-INTEGRATION.md index 026a9a2..368a647 100644 --- a/docs/CLAIRE-FREEBSD-HERMES-INTEGRATION.md +++ b/docs/CLAIRE-FREEBSD-HERMES-INTEGRATION.md @@ -8,6 +8,7 @@ Four targeted patches (setup.py, uninstall.py, voice_mode.py, install script). No LGPL encumbrance — pure MIT, same as upstream. **Key facts:** + - Runs on FreeBSD without emulation or containers - CLI, Telegram gateway, TUI all functional on FreeBSD - `scripts/install-freebsd.sh` provides native installation @@ -20,14 +21,14 @@ Currently OSA (FreeBSD 15 host) runs Codex CLI for ISO builds and cargo validati 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 | +| 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 @@ -62,29 +63,29 @@ Autolycus to OSA gives us: ## 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** | +| 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) | +| 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 | +| File | Change | +| ----------------------------------------------- | ---------------------------------------- | +| `layered-soul/memories/curated/agent-roster.md` | Add Autolycus row | +| `layered-soul/AGENTS.md` | Add Autolycus to agent references | +| `layered-soul/docs/CONNECT-HERMES-SOUL.md` | Document FreeBSD agent source connection | +| `clawdie-ai/docs/` (or handoff) | Agent matrix expansion note | +| `colibri/docs/AGENTS.md` | Note FreeBSD-side Hermes availability | diff --git a/memories/curated/agent-roster.md b/memories/curated/agent-roster.md index 9e728dc..b82d506 100644 --- a/memories/curated/agent-roster.md +++ b/memories/curated/agent-roster.md @@ -2,30 +2,30 @@ ## Active agents -| 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 | +| 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 | ## 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 | +| 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 | +| 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 diff --git a/skills/README.md b/skills/README.md index 6278e4d..034b75e 100644 --- a/skills/README.md +++ b/skills/README.md @@ -4,17 +4,18 @@ Cross-harness skills reviewed and imported from the private `hermes-soul` runtim ## Included skills -| Skill | Category | Purpose | -| ------------------------- | ------------ | ----------------------------------------------------------------- | -| forgejo-operations | devops | Manage self-hosted Forgejo — repos, users, PRs, branch protection | -| vaultwarden-secrets | devops | Self-hosted Vaultwarden + Bitwarden CLI for agent secrets | -| bootable-usb-images | devops | Download, verify, flash compressed bootable USB images | -| herdr-deployment | devops | Build, configure, deploy Herdr terminal workspace manager | -| colibri-development | software-dev | Develop in the Colibri Rust workspace — builds, tests, crates | -| systematic-debugging | software-dev | 4-phase root cause debugging methodology | -| test-driven-development | software-dev | TDD: RED-GREEN-REFACTOR cycle enforcement | -| codebase-knowledge-graphs | software-dev | Build/query persistent codebase knowledge graphs | -| vision-model-setup | mlops | Configure and troubleshoot vision capabilities across providers | +| Skill | Category | Purpose | +| ------------------------- | ------------ | ------------------------------------------------------------------------ | +| forgejo-operations | devops | Manage self-hosted Forgejo — repos, users, PRs, branch protection | +| vaultwarden-secrets | devops | Self-hosted Vaultwarden + Bitwarden CLI for agent secrets | +| bootable-usb-images | devops | Download, verify, flash compressed bootable USB images | +| herdr-deployment | devops | Build, configure, deploy Herdr terminal workspace manager | +| colibri-development | software-dev | Develop in the Colibri Rust workspace — builds, tests, crates | +| systematic-debugging | software-dev | 4-phase root cause debugging methodology | +| test-driven-development | software-dev | TDD: RED-GREEN-REFACTOR cycle enforcement | +| codebase-knowledge-graphs | software-dev | Build/query persistent codebase knowledge graphs | +| freebsd-cost-optimization | devops | Use Colibri cost modes (fast/smart/max) to minimize API spend on FreeBSD | +| vision-model-setup | mlops | Configure and troubleshoot vision capabilities across providers | ## Adding skills