The cheerful companion toolbox that keeps long agent sessions tidy, searchable, and share-ready — without changing Hermes Agent itself.
🌈 Visit the website · 📦 Install guide · 🧩 Component catalog · 🐛 Report a bug
Long agent sessions move fast. A tool call surfaces a golden clue, a test log answers the big question… and ten minutes later it's all buried in scrollback. Your agent forgets, you scroll forever, and nobody can retrace how the answer was found.
Harness Plus wraps a small, friendly harness around Hermes Agent — optional adapters, plugins, sidecars, skills, and checklists that build three healthy habits:
| Habit | What it means | Powered by |
|---|---|---|
| 🗺️ Keep the map | Compact progress notes on a Task Canvas, with raw evidence parked in referenced files | context-canvas |
| 🔎 Find it again | Semantic recall over your skills & recent sessions — 100% local, on your own Qdrant | qdrant_* helpers |
| 🎁 Share cleanly | Install notes, release routines, and reusable skills that travel well to other users | skills/ + ops-rules/ |
Everything is opt-in and operator-controlled. Local-state components keep their data on your machine; provider-backed components document what leaves it and fail closed at credential and route boundaries. Take one piece or take them all — Hermes Agent itself is never modified. 🤝
hermes-agent-harness-plus/
├── 📦 packages/context-canvas/ Task Canvas library + CLI + MCP wrappers
├── 🗃️ plugins/context-canvas-autopilot/ Archived broad-capture experiment
├── 🤖 plugins/prime-minion/ Prime Agent coding runtime with Hermes-owned Codex auth
├── 🔧 scripts/ Qdrant & Canvas helpers: MCP, indexing, watchdogs
├── 📚 skills/ Teach Hermes when & how to use the harness
├── ✅ ops-rules/ Release / handoff / scheduled-job checklists
└── 📖 docs/ Website, install guide, technical notes
| Component | Superpower |
|---|---|
| 🗺️ Context Canvas | Short JSON nodes + evidence refs — the agent keeps the shape of the work and a path back to the facts |
| 🛰️ Canvas MCP sidecar | Native MCP tools: start/read/search/closeout, recover recent canvas IDs with canvas_recent, or atomically attach evidence + a node with canvas_record |
| 🔎 Qdrant recall kit | Index selected skills & recent sessions locally; dry-run previews and secret-pattern redaction by default |
| 🩺 Recall watchdog | Quiet when healthy, loud when broken — validates collections after refreshes, container starts, and restarts |
| 📚 Public skills | context-canvas-memory, bounded context-canvas-reflection, and qdrant-recall-sidecar — drop-in guidance for any Hermes Agent user |
| 🧭 Delegation calibrator | Optional complexity × Bayesian evidence for direct vs luna_max; Baton remains the qualitative dispatch brake and validation authority |
| 🤖 Prime minion bridge | Run Prime Agent's coding loop with Hermes-owned Codex OAuth, explicit route readback, and optional resumable transcripts across fresh processes |
The former Autopilot broad-capture plugin remains as a source archive for historical safety replay. Its production runtime is forced off; it is not an installation option.
# 1. Grab the toolbox
git clone https://github.com/phenomenoner/hermes-agent-harness-plus.git
cd hermes-agent-harness-plus
# 2. Prove it works on your machine
python -m pip install -e '.[mcp]' pytest
python -m pytest -q
# 3. Start your first Task Canvas 🎉
PYTHONPATH=packages/context-canvas python -m context_canvas.cli start \
--session-id demo \
--goal "Keep evidence for a long Hermes task"Then wire it into Hermes Agent (full walkthrough in the install guide):
# Hermes Agent config.yaml
mcp_servers:
context_canvas:
command: "python"
args: ["/absolute/path/to/hermes-agent-harness-plus/scripts/context_canvas_mcp_server.py"]
env:
HERMES_CONTEXT_CANVAS_HOME: "/home/you/.hermes/context-canvas"- 🏠 Local state by default. Canvas, Qdrant, and minion transcripts stay on your machine; provider-backed calls follow the provider you explicitly configured.
- 🪶 Featherweight. Optional pieces around Hermes Agent — zero changes to Hermes itself. Start with an explicit Canvas and add only the helpers you need.
- 🛟 The right failure mode. Observability helpers fail open; credential, route, ownership, and replay boundaries fail closed.
- 🔍 Separate map from evidence. Concise Canvas nodes stay easy to scan while referenced files retain the verifiable details.
- 🧾 Evidence or it didn't happen. Every finished note points to a ref you can verify:
node summary → evidence ref → original content.
| Guide | What you'll find |
|---|---|
| 🌈 Website | The pretty tour |
| ✦ Context Canvas origin story | A first-person product diary: the late-night idea, the first live capture, and the repair that made it real |
| 📦 Install & enable | Step-by-step setup: CLI, MCP, retired-plugin cleanup, Qdrant, skills |
| 🧩 Component catalog | Every piece, its purpose, and its safety posture |
| 🗺️ Context Canvas internals | Data model & technical notes |
| 🧾 Autopilot v2 archive | Historical broad-capture design, retirement decision, and retained safety replay |
| 🔎 Qdrant recall internals | Indexing, collections & health checks |
| ✅ Context Canvas awareness | Standing selection rule for deliberate task maps and bounded trajectory reflection, without granting task authority |
| 🧭 Delegation calibrator | Optional complexity × Bayesian routing evidence; Baton remains the dispatch brake and the main agent owns final judgment |
| 🤖 Prime minion bridge | Install, route, resume, inspect, and close Prime Agent minion sessions while Hermes keeps Codex credentials |
| 🧠 Prime minion internals | Credential boundary, route readback, process lifecycle, and interrupted-session contract |
| ✅ Prime minion PMO routing | Standing authority, execution, review, and fallback rule for a PMO stance |
| 🚀 Release manifest | What ships in each bundle |
Found a bug? Have a helper that made your Hermes life better? We'd love it! 💌
Read CONTRIBUTING.md first — the golden rule is share-ready: no secrets, no machine-specific paths, copy-pasteable install steps. See also our Code of Conduct and Security policy.
MIT — see LICENSE and NOTICE for third-party pointers (Hermes Agent, Qdrant, MCP SDK, FastEmbed 💕).
Pick the pieces you need, leave the rest — and may your agent never lose a clue again. 🧸✨
Built as a companion toolbox for Hermes Agent users.