All plugins

session-find

A search window over your Hermes session history, opened with Cmd+Option+F, from the command palette, or from the glyph in the bottom bar whose hover shows the chord. Finds a session by an exact word, identifier or phrase through the gateway's own full text index, and by meaning as well when a session-find service answers on loopback; typed filters (in:, -in:, after:, before:, me:, repo: and quoted phrases) are mirrored as chips under the box. The empty box lists pinned then recent sessions, the preview pane shows the matching message with its neighbours, and the footer carries the round trip in whole milliseconds. It reads the session database read only, registers no agent tools, hooks or middleware, needs no credentials or environment variables; its only network calls are the loopback checks named below. The window half ships off by default and is switched on in the app's plugin inventory. Disclosure — while the search window is in use, the plugin's dashboard backend checks every 30 seconds for a separate session-find service at http://127.0.0.1:8474 (or the URL in SESSION_FIND_URL) and, when one answers, sends it your search text, preview requests and the ids of sessions you open, and shows the results it returns; otherwise it reads your Hermes session database read-only.

djmangoDesktopv1.0.0Updated 28 days ago

About

A search window over your Hermes session history, opened with Cmd+Option+F, from the command palette, or from the glyph in the bottom bar whose hover shows the chord. Finds a session by an exact word, identifier or phrase through the gateway's own full text index, and by meaning as well when a session-find service answers on loopback; typed filters (in:, -in:, after:, before:, me:, repo: and quoted phrases) are mirrored as chips under the box. The empty box lists pinned then recent sessions, the preview pane shows the matching message with its neighbours, and the footer carries the round trip in whole milliseconds. It reads the session database read only, registers no agent tools, hooks or middleware, needs no credentials or environment variables; its only network calls are the loopback checks named below. The window half ships off by default and is switched on in the app's plugin inventory. Disclosure — while the search window is in use, the plugin's dashboard backend checks every 30 seconds for a separate session-find service at http://127.0.0.1:8474 (or the URL in SESSION_FIND_URL) and, when one answers, sends it your search text, preview requests and the ids of sessions you open, and shows the results it returns; otherwise it reads your Hermes session database read-only.

Session Find

A search window over your Hermes session history. Press Cmd+Option+F, type what
you remember, and the sessions that talked about it come back as a list you can
walk with the arrow keys.

Find a session
Type what you remember. Arrow keys move, Enter opens, Tab switches Best match and Newest.

It is a window, not a page: it gets no sidebar row, and it opens from three doors,
the keybind, Cmd+K ("Find a session"), and the search glyph in the bottom bar
whose hover shows the chord.

What it does

  • Searches everything you have ever said to Hermes, not just titles: message
    text, tool output and tool arguments are all in the index.
  • Matches words or meanings. Keywords finds an exact word, identifier or
    phrase. Meaning finds a session by what it was about, which is how you find the
    conversation where you discussed something whose name you have forgotten.
  • Typed filters, mirrored as chips under the box: in:source, -in:source,
    after:, before:, me:, repo:, and "an exact phrase" in quotes.
  • A preview pane with the matching message and its neighbours, so you can tell
    two similar sessions apart before opening one.
  • Pinned and recent sessions on the empty box, and the age of every row.
  • The wait, in the footer: 30 sessions · 27 ms, the round trip for the list
    on screen, coloured by how quick it was.

Requirements

None. No credentials, no environment variables, no network access. It reads the
session database the gateway already keeps, read only.

The window answers from one of two backends, and /status decides which:

backendwhencan do
servicea session-find service answers on 127.0.0.1:8474 (or SESSION_FIND_URL)keywords and meanings
nativeno service is runningkeywords only

The native backend is the gateway's own SQLite full text index over messages, so
a fresh install has a working window with nothing else to run. When a service is
not there, the window keeps Keywords on, greys the Meaning glyph and says on its
hover why, rather than failing your first search. Point SESSION_FIND_URL at a
service to get the meaning half as well; SESSION_FIND_STATE_DB overrides the
database the native backend reads.

Install

hermes plugins install djmango/session-find
hermes plugins enable session-find

The window half ships off by default, because it draws inside the app. Switch
it on in the app's plugin inventory (Capabilities, then Plugins), and the glyph
appears in the bottom bar. Then press Cmd+Option+F.

By hand, if you prefer: copy this directory to <hermes home>/plugins/session-find
and the window to <hermes home>/desktop-plugins/session-find/plugin.js, then
reload desktop plugins from Cmd+K.

Keys

keywhat it does
Cmd+Option+Fopen the window
Up / Downmove the highlight
Cmd+J / Cmd+Kmove the highlight, on macOS
Enteropen the highlighted session
Cmd+Enteropen it in a new tab, Cmd+Shift+Enter in a new window
Tabswitch Best match and Newest
Cmd+Rcycle the scope: all sessions, this profile, this repo
Escapeclose the window

A move never opens anything: only Enter or a click does.

What it does not do

  • No vector search without a service. The native backend has no model, so
    Meaning needs a session-find service. Keywords works everywhere.
  • No writes. The session database is opened read only; the only thing the
    plugin stores is your two toggle choices and the sort order, in plugin storage.
  • No network calls. The window talks to the gateway it already has a session
    with, and the gateway talks to 127.0.0.1 when a service is configured.
  • No agent tools, hooks or middleware. It registers none, and declares none.

Develop

The window is desktop/plugin.js, plain ESM loaded uncompiled by the app, so
nothing typechecks it. Its tests guard what a compiler would not:

node --test tests/plugin.test.mjs

They check that no jsx() call carries a third argument (that slot is the element
key, and children put there vanish), that only @hermes/plugin-sdk, react and
react/jsx-runtime are imported, that no em dash or emoji reached the file, that
the keybind does not collide with a built-in one, and that the pure helpers behind
the chips, the keys, the rows and the footer behave.

License

MIT. See LICENSE.

README from the reviewed commit caf185c; it updates when the author re-pins.

More by djmango

2 plugins by djmango in the catalog.

Developer Mode

Explore built-in Hermes toolsets and actions.

HermesAgent

Developer?

Create a Hermes extension for Desktop or agent workflows.

Developer Section