hermes-mods

Custom patches for NousResearch/hermes-agent, plus the Fish shell config and infra that keeps them applied across upstream updates.

What's in here

Feature	Folder	Commits
Reasoning summarizer (Ollama, section-based, "Show full" toggle)	patches/reasoning-summarizer/	3
Live clock + session waiting indicator (●/○) in status bar	patches/clock-widget/	1
Keyboard shortcuts: Ctrl+N new, Ctrl+D/W close+switch, Ctrl+Q quit	patches/ctrl-n-d/	3
Fuzzy search in session orchestrator (type to filter)	patches/fuzzy-session-filter/	2
Sequential Image #N labels for attached images (privacy)	patches/image-numbering/	1
Multi-session resume — --tui --continue restores all past sessions	patches/session-persistence/	2
Continuous session title updates after every exchange	patches/session-titles/	1

13 commits total, ~25 files touched. Each mod's patchset applies independently to a clean origin/main.

Each folder has an AGENTS.md with a detailed description of every file changed, the configuration options, and how to verify it works.

Install

# 1. Clone hermes-agent and create a patches branch
git clone git@github.com:NousResearch/hermes-agent.git ~/.hermes/hermes-agent
cd ~/.hermes/hermes-agent
git checkout -b xrisks-patches origin/main

# 2a. Apply all mods at once
for mod in reasoning-summarizer clock-widget ctrl-n-d fuzzy-session-filter \
           image-numbering session-persistence session-titles; do
  git am ~/dev/hermes-mods/patches/$mod/*.patch
done

# 2b. Or apply a single mod
git am ~/dev/hermes-mods/patches/clock-widget/*.patch

# 3. Build the TUI
npm install && npm run build --prefix ui-tui

# 4. Install Hermes in development mode
uv pip install --system -e .

Verified 2026-05-30: all 7 per-mod patchsets apply cleanly and independently to origin/main.

Auto-sync on launch (Fish shell)

config/fish/conf.d/hermes-patches.fish wraps the hermes command so that on every launch it:

1. Detects if you've drifted to main and auto-switches back to xrisks-patches
2. Fetches and merges origin/main into xrisks-patches (silent if clean)
3. On merge conflict: runs claude -p to auto-resolve, then rebuilds the TUI
4. Wraps hermes update so upstream pulls are seamlessly followed by patch re-application

Copy it into place:

cp ~/dev/hermes-mods/config/fish/conf.d/hermes-patches.fish ~/.config/fish/conf.d/

Patch structure

Each subdirectory contains an independent patchset rebased directly onto origin/main. Apply any mod in isolation:

git am ~/dev/hermes-mods/patches/<mod-name>/*.patch

Note on image-numbering: originally committed alongside two trivial formatting lines inside the reasoning-summarizer block; those lines were stripped when rebasing so this patchset is fully independent.

Keeping patches up to date

After making a change on xrisks-patches, regenerate the affected mod's subdirectory:

cd ~/.hermes/hermes-agent
# create a temp branch with only that mod's commits rebased onto origin/main, then:
git format-patch origin/main..<temp-branch> -o ~/dev/hermes-mods/patches/<mod>/
# commit the updated patches in hermes-mods

See AGENTS.md for the full workflow including rebasing, conflict resolution, and the hermes update integration.