Memory Search
Search the Appie brain — daily logs, project notes, decisions, topics, and long-term memory.
When to Use
- User asks about past decisions, conversations, or context
- User says "remember when...", "what did we decide about...", "check my notes on..."
- You need project context, client info, or infrastructure details
- Looking up dates, events, or historical information
Memory Structure
All files are in ~/.hermes/memory/:
- Daily logs:
YYYY-MM-DD.md — raw daily notes
- Topics:
topics/*.md — subject-specific knowledge
- Projects:
projects/*.md — project documentation
- Decisions:
decisions/*.md — recorded decisions
- Infrastructure:
infrastructure/*.md — server/fleet notes
- Plans:
plans/*.md — future plans
- Research:
research/*.md — research notes
Top-level brain files in ~/.hermes/:
MEMORY.md — curated long-term memory (read this first)USER.md — info about the human (Seyed)TOOLS.md — tool configuration and fleet SSH detailsIDENTITY.md — agent identity
Search Commands
Full-text search across all memory files
grep -ril "SEARCH_TERM" ~/.hermes/memory/ ~/.hermes/MEMORY.md ~/.hermes/USER.md ~/.hermes/TOOLS.md 2>/dev/null
Search with context (shows surrounding lines)
grep -rin -C 3 "SEARCH_TERM" ~/.hermes/memory/ 2>/dev/null | head -60
List recent daily logs
ls -t ~/.hermes/memory/????-??-??.md 2>/dev/null | head -10
Read a specific daily log
cat ~/.hermes/memory/YYYY-MM-DD.md
Search by date range (e.g., March 2026)
ls ~/.hermes/memory/2026-03-*.md 2>/dev/null
Search topics
ls ~/.hermes/memory/topics/ 2>/dev/null
grep -ril "SEARCH_TERM" ~/.hermes/memory/topics/ 2>/dev/null
Search projects
ls ~/.hermes/memory/projects/ 2>/dev/null
grep -ril "SEARCH_TERM" ~/.hermes/memory/projects/ 2>/dev/null
Advanced: fuzzy search with script
python3 ~/.hermes/skills/productivity/memory-search/scripts/search.py "QUERY" [--limit 10] [--recent 7]
Quick Reference
Always start with MEMORY.md for curated long-term context, then search daily logs for specifics.
Workflow
- Read
~/.hermes/MEMORY.md for high-level context
- If more detail needed, search with
grep -ril across memory/
- Read the specific files that match
- Synthesize and answer
Project PRD / "last wishes" recall pattern
When the user asks whether you remember a PRD, brief, handoff, or their "last wishes":
- Ground the answer before claiming memory. Search both long-term memory and the likely project directory for
PRD, Handoff, README, Open decisions, TODO, wishes, and the project/client name.
- Prefer canonical project artifacts over chat fragments:
docs/PRD*.md, HANDOFF.md, README.md, AGENTS.md, PROJECT_STATE.md, and deployment manifests.
- If multiple projects match, use the strongest local context and say which project you verified. Ask only if the ambiguity changes the answer.
- Separate confirmed facts from inferred "last wishes". Example shape: "Verified PRD says X. Handoff/open decisions say Y. I do not see a separate file literally named last wishes."
- Keep the reply short unless the user asks for the full doc. For Seyed, answer with the remembered decisions and blockers, not a tool-by-tool narrative.
1---2name: memory-search3description: Search and retrieve information from the Appie brain — daily logs, project notes, decisions, topics, and long-term memory files stored in ~/.hermes/memory/. Use this skill whenever you need to recall past conversations, decisions, project context, personal preferences, or anything discussed previously.4license: MIT5---67# Memory Search89Search the Appie brain — daily logs, project notes, decisions, topics, and long-term memory.1011## When to Use1213- User asks about past decisions, conversations, or context14- User says "remember when...", "what did we decide about...", "check my notes on..."15- You need project context, client info, or infrastructure details16- Looking up dates, events, or historical information1718## Memory Structure1920All files are in `~/.hermes/memory/`:2122- **Daily logs**: `YYYY-MM-DD.md` — raw daily notes23- **Topics**: `topics/*.md` — subject-specific knowledge24- **Projects**: `projects/*.md` — project documentation25- **Decisions**: `decisions/*.md` — recorded decisions26- **Infrastructure**: `infrastructure/*.md` — server/fleet notes27- **Plans**: `plans/*.md` — future plans28- **Research**: `research/*.md` — research notes2930Top-level brain files in `~/.hermes/`:31- `MEMORY.md` — curated long-term memory (read this first)32- `USER.md` — info about the human (Seyed)33- `TOOLS.md` — tool configuration and fleet SSH details34- `IDENTITY.md` — agent identity3536## Search Commands3738### Full-text search across all memory files39```bash40grep -ril "SEARCH_TERM" ~/.hermes/memory/ ~/.hermes/MEMORY.md ~/.hermes/USER.md ~/.hermes/TOOLS.md 2>/dev/null41```4243### Search with context (shows surrounding lines)44```bash45grep -rin -C 3 "SEARCH_TERM" ~/.hermes/memory/ 2>/dev/null | head -6046```4748### List recent daily logs49```bash50ls -t ~/.hermes/memory/????-??-??.md 2>/dev/null | head -1051```5253### Read a specific daily log54```bash55cat ~/.hermes/memory/YYYY-MM-DD.md56```5758### Search by date range (e.g., March 2026)59```bash60ls ~/.hermes/memory/2026-03-*.md 2>/dev/null61```6263### Search topics64```bash65ls ~/.hermes/memory/topics/ 2>/dev/null66grep -ril "SEARCH_TERM" ~/.hermes/memory/topics/ 2>/dev/null67```6869### Search projects70```bash71ls ~/.hermes/memory/projects/ 2>/dev/null72grep -ril "SEARCH_TERM" ~/.hermes/memory/projects/ 2>/dev/null73```7475### Advanced: fuzzy search with script76```bash77python3 ~/.hermes/skills/productivity/memory-search/scripts/search.py "QUERY" [--limit 10] [--recent 7]78```7980## Quick Reference8182Always start with `MEMORY.md` for curated long-term context, then search daily logs for specifics.8384## Workflow85861. Read `~/.hermes/MEMORY.md` for high-level context872. If more detail needed, search with `grep -ril` across memory/883. Read the specific files that match894. Synthesize and answer9091## Project PRD / "last wishes" recall pattern9293When the user asks whether you remember a PRD, brief, handoff, or their "last wishes":94951. Ground the answer before claiming memory. Search both long-term memory and the likely project directory for `PRD`, `Handoff`, `README`, `Open decisions`, `TODO`, `wishes`, and the project/client name.962. Prefer canonical project artifacts over chat fragments: `docs/PRD*.md`, `HANDOFF.md`, `README.md`, `AGENTS.md`, `PROJECT_STATE.md`, and deployment manifests.973. If multiple projects match, use the strongest local context and say which project you verified. Ask only if the ambiguity changes the answer.984. Separate confirmed facts from inferred "last wishes". Example shape: "Verified PRD says X. Handoff/open decisions say Y. I do not see a separate file literally named last wishes."995. Keep the reply short unless the user asks for the full doc. For Seyed, answer with the remembered decisions and blockers, not a tool-by-tool narrative.
S3YED