Skip to content

Commit b4e8026

Browse files
committed
docs: fix Hermes TLDR install path
1 parent e5bd097 commit b4e8026

1 file changed

Lines changed: 10 additions & 15 deletions

File tree

data/agent-locations.md

Lines changed: 10 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -15,11 +15,11 @@ Where to drop `TLDR.md` (or `TLDR.blunt.md`) for each supported coding-agent CLI
1515
| 5 | opencode (SST opencode) | `~/.config/opencode/AGENTS.md` | full overwrite |
1616
| 6 | droid (Factory Droid) | `~/.factory/AGENTS.md` | full overwrite |
1717
| 7 | pi (Pi Coding Agent) | `~/.pi/agent/AGENTS.md` | full overwrite |
18-
| 8 | hermes (Hermes built-in memory) | `~/.hermes/memories/MEMORY.md` | **append** as new `§`-block |
18+
| 8 | hermes (Hermes persona/instructions) | `~/.hermes/SOUL.md` | append or merge into existing persona file |
1919

20-
> **Hermes is special.** Its built-in `MEMORY.md` is "always active" memory containing user-curated entries separated by `§`. **Do not overwrite** — append the TLDR prompt as a new memory block (separated by `§`). Or condense to a single dense paragraph since hermes treats memory entries as prose blocks.
20+
> **Hermes is special.** Put TLDR in `~/.hermes/SOUL.md`, not `MEMORY.md`. `SOUL.md` is the live persona/instruction file loaded every message; `MEMORY.md` is for user/profile memory and should not be used as a prompt dump.
2121
22-
The file is just the prompt by itself — no merge, no append (except hermes).
22+
The file is just the prompt by itself — no merge, no append, except Hermes where you usually merge it into the existing `SOUL.md` persona.
2323

2424
## ⚡ Fastest install — pick your agent, run one line
2525

@@ -48,18 +48,13 @@ for d in ~/.claude/CLAUDE.md ~/.gemini/GEMINI.md ~/.codex/AGENTS.md \
4848
done
4949
```
5050

51-
### Hermes (append, don't overwrite)
51+
### Hermes (merge into SOUL.md)
5252

5353
```bash
54-
mkdir -p ~/.hermes/memories
55-
# Get current memory (preserves any user notes)
56-
EXISTING=$(cat ~/.hermes/memories/MEMORY.md 2>/dev/null)
57-
# Append TLDR as new §-section
58-
{
59-
echo "$EXISTING"
60-
[ -n "$EXISTING" ] && echo "§"
61-
curl -fsSL "$TLDR_URL"
62-
} > ~/.hermes/memories/MEMORY.md
54+
mkdir -p ~/.hermes
55+
# If you already have a persona in SOUL.md, merge TLDR into it instead of replacing it blindly.
56+
# If you want TLDR only, overwrite SOUL.md directly:
57+
curl -fsSL "$TLDR_URL" -o ~/.hermes/SOUL.md
6358
```
6459

6560
## Per-agent notes
@@ -101,8 +96,8 @@ for p in ~/.claude/CLAUDE.md ~/.gemini/GEMINI.md ~/.codex/AGENTS.md \
10196
~/.factory/AGENTS.md ~/.pi/agent/AGENTS.md; do
10297
[ -f "$p" ] && grep -q "^# TLDR" "$p" && echo "$p" || echo "$p"
10398
done
104-
# Hermes (different format — looks for the TLDR.blunt mode marker in MEMORY.md)
105-
grep -q "TLDR.blunt mode" ~/.hermes/memories/MEMORY.md 2>/dev/null && echo "✓ ~/.hermes/memories/MEMORY.md" || echo "✗ ~/.hermes/memories/MEMORY.md"
99+
# Hermes
100+
grep -q "^# TLDR" ~/.hermes/SOUL.md 2>/dev/null && echo "✓ ~/.hermes/SOUL.md" || echo "✗ ~/.hermes/SOUL.md"
106101
```
107102

108103
You should see ✓ for each of the locations you actually installed to.

0 commit comments

Comments
 (0)