diff --git a/AGENTS.md b/AGENTS.md index 3292d5f..64c40bf 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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) diff --git a/docs/CLAIRE-FREEBSD-HERMES-INTEGRATION.md b/docs/CLAIRE-FREEBSD-HERMES-INTEGRATION.md new file mode 100644 index 0000000..fe40ab9 --- /dev/null +++ b/docs/CLAIRE-FREEBSD-HERMES-INTEGRATION.md @@ -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 | diff --git a/memories/curated/agent-roster.md b/memories/curated/agent-roster.md index 47cdf89..9e728dc 100644 --- a/memories/curated/agent-roster.md +++ b/memories/curated/agent-roster.md @@ -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