Hermy HQ: self-hostable mission-control template for your Hermes agent
A Next.js 16 + Prisma/Postgres dashboard that pairs with a local Hermes agent over a Postgres message bus: dispatch work, approve side-effecting actions, browse the agent's memory, and watch it run. Ships with an agent-onboarding prompt (ONBOARDING.md) so your Hermes can install it for you step by step. All secrets are env-configured; nothing sensitive is bundled. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
commit
b463027468
153 files changed
+37795
No files matched your search
@@ -0,0 +1,57 @@
|
||||
---
|
||||
name: wiki
|
||||
description: >
|
||||
Long-term memory wiki. Use this whenever you learn, decide, or are corrected on
|
||||
something durable that is too big or too detailed for MEMORY.md. Read from and
|
||||
write to ~/.hermes/wiki as your warm, git-tracked, never-forget memory.
|
||||
version: 1.0.0
|
||||
---
|
||||
|
||||
# Memory Wiki
|
||||
|
||||
`MEMORY.md` and `USER.md` are your tiny hot cache (~1,300 tokens total, always in
|
||||
context). The **wiki** at `~/.hermes/wiki/` is your warm, unlimited, git-tracked
|
||||
long-term memory. It is browsed and edited by the operator in Hermy HQ, so keep it clean.
|
||||
|
||||
## When to write to the wiki (not MEMORY.md)
|
||||
- After any complex task (5+ tool calls): append a line to `log/YYYY-MM.md` and, if you
|
||||
learned something reusable, create/update a `lessons/` entry.
|
||||
- When the operator makes a **decision** → a `decisions/` entry with the rationale + date.
|
||||
- When you learn a durable fact about a **project, person, or the business** that is
|
||||
bigger than a one-liner → a `projects/`, `people/`, or `facts/` entry.
|
||||
- When corrected ("no, do it this way") → update the relevant entry; **don't delete the
|
||||
old value — mark it `status: superseded`** and add the new fact. Preserve history.
|
||||
- Keep MEMORY.md for only ~10-20 always-true, high-frequency facts, plus a pointer:
|
||||
`Full long-term memory at ~/.hermes/wiki — grep/read it before answering project questions.`
|
||||
|
||||
## Entry format (one markdown file per entry, YAML frontmatter + body)
|
||||
```
|
||||
---
|
||||
id: proj-viralpen
|
||||
type: project # fact | preference | decision | event | project | contact | lesson | metric | note
|
||||
title: ViralPen.ai SaaS
|
||||
status: active # active | superseded | archived
|
||||
confidence: high # high | medium | low
|
||||
provenance: user-stated # user-stated | observed | web | session:<id>
|
||||
tags: [saas, billing]
|
||||
links: [decision-pricing-99]
|
||||
updated: 2026-07-23
|
||||
---
|
||||
Multi-tenant article studio at ~/viralpen. $99/mo. Twitter OAuth.
|
||||
## Open loops
|
||||
- [ ] Migrate billing to usage-based (see decision-pricing-99)
|
||||
```
|
||||
Files live under type folders: `projects/`, `people/`, `decisions/`, `lessons/`,
|
||||
`facts/`, `log/`. Keep `INDEX.md` updated (one line per entry: `id · title · type · updated`).
|
||||
|
||||
## Retrieval (before answering)
|
||||
1. `INDEX.md` is injected hot — scan it for the right entry id.
|
||||
2. `search_files ~/.hermes/wiki "<term>"` or read the specific file with `read_file`.
|
||||
3. If still unsure, `session_search` the conversation history (free, unlimited).
|
||||
Only pull the 1-2 entries you actually need — don't load the whole wiki.
|
||||
|
||||
## Hygiene
|
||||
- After writing, `git -C ~/.hermes/wiki add -A && git commit -m "wiki: <what changed>"`.
|
||||
- Never destroy history — supersede, don't overwrite.
|
||||
- The nightly `wiki-consolidate` cron merges duplicates, demotes stale entries, and
|
||||
rebuilds INDEX.md — keep entries small and single-purpose so it can.
|
||||
Reference in new issue
Block a user