The library under Hermes — long memory as a book of chapters, offline, under your home.
HermesCube is the core deep-memory of a Hermes base — a local library that keeps years of agent life and compresses it into chapters (arcs), not a second chatbot and not a cloud memory SaaS.
Hermes Agent is the librarian on duty (tools, chat, skills).
HermesCube is the stacks. Hot MEMORY.md is the desk card catalog. The bound volume is $HERMES_HOME/memories/memory.cube.
| Library idea | In the product |
|---|---|
| Book | one memory.cube per Hermes home / profile |
| Chapter / arc | crystals, growth eras, dream consolidations, project spines |
| Page | a landmark, belief, trait, or relationship entry |
| Card catalog | hot MEMORY.md + journey |
| Heart / provenance | blackbox flight records — prove work was done |
| Safe lock / ark | checkpoint — flash clone of book + core identity |
| Inter-library loan | optional Hive (multi-agent), not required day one |
No cloud memory APIs. Your data stays under $HERMES_HOME/memories/. Updates never wipe the book.
| Works with Hermes, not instead of it | Hot MEMORY.md stays always-on. Cube is the long library Hermes loads through memory.provider. |
| Semantic shelves, local | HAR + learned embeddings + entity graphs — meaning over grepping CCTV logs. No embedding SaaS. |
| Compress over years | Append pages, then bind chapters (crystalize, merge, dream). Context windows are not the archive. |
| Prove, don’t vibe | Blackbox captures redacted trajectories and proves claims (“tests pass”) against evidence. |
| Heart for Hermespace | Heart + center — Cube generates FOA blood; Space focuses the turn. |
| Solo library first | Hive / HQ / dream-circles are inter-library loan. Open the building before the consortium. |
Pitch: ABOUT.md. North star: PURPOSE.md. Full map: docs/ARCHITECTURE.md.
# Option A — Hermes plugin installer (recommended)
hermes plugins install PabloTheThinker/hermescube
cd "${HERMES_HOME:-$HOME/.hermes}/plugins/hermescube"
./scripts/install_hermes.sh
hermes config set memory.provider hermescube
# Option B — clone then install
git clone https://github.com/PabloTheThinker/hermescube.git
cd hermescube
./scripts/install_hermes.sh
hermes config set memory.provider hermescubeDay-one library open:
hermescube setup # any Hermes user — wire THIS HERMES_HOME
hermescube connect # idempotent attach
hermescube status
hermes memory status
hermescube query "what do we know about…"
hermescube blackbox capture --latest
hermescube blackbox prove --claim "tests pass" --latestFull terminal guide: docs/CLI.md.
| Path | Who owns it |
|---|---|
$HERMES_HOME/plugins/hermescube/ |
Plugin code |
$HERMES_HOME/memories/memory.cube |
Your book |
$HERMES_HOME/config.yaml |
memory.provider: hermescube |
hermescube updatehermes update updates Hermes Agent only. Cube is a plugin. The book is never overwritten by update.
hermescube doctor # is the library healthy?
hermescube info # volume stats
hermescube query "…" # find passages by meaning
hermescube blackbox capture --latest
hermescube blackbox prove --claim "tests pass" --latest
hermescube blackbox breathe --latest # advanced: prove + seal + relations
hermescube checkpoint create --name "pre-risk" --label "Safe lock before change"
hermescube checkpoint list
hermescube dream status # chapter-binding night cycle
hermescube dense # portable text backup (vectors stay local)Agent tools (when provider is on):
| Tool | Purpose |
|---|---|
hermescube_search |
Find passages in the book |
hermescube_manage |
Warehouse · Cuboasis · growth · fleet · dream |
hermescube_feedback |
Mark recalls helpful / unhelpful |
hermescube_probe |
Entity focus / diagnostics |
| Doc | Read when |
|---|---|
| ABOUT.md | Library metaphor + what/why |
| PURPOSE.md | North star (Hermes-base core) |
| docs/ARCHITECTURE.md | Full blueprint |
| docs/BLACKBOX.md | Flight recorder / prove |
| docs/CHECKPOINT.md | Safe locks — identity ark + cube clone |
| docs/SECURITY.md | No leakage · profile isolation · harden |
| docs/HERMESPACE.md | Heart ↔ desk |
| docs/ANATOMY.md | Center organs (incl. blackbox) |
| docs/README.md | Full index |
HermesCube is the library under Hermes: a local book of long memory that compresses life into chapters, with a heart that can prove what was actually done.
Day-one surface: remember · prove · doctor. Advanced organs stay documented, not forced.
MIT — LICENSE
Home: https://github.com/PabloTheThinker/hermescube