All plugins

session-ref

Reference another Hermes session in the Desktop composer with @session — type @ and pick from live session suggestions. Inserts a compact @session:"<title>" reference; nothing is injected into context, the agent resolves it with its own session-search. No more copying session IDs.

kama-devDesktopv0.1.1Updated 1 month ago

About

Reference another Hermes session in the Desktop composer with @session — type @ and pick from live session suggestions. Inserts a compact @session:"<title>" reference; nothing is injected into context, the agent resolves it with its own session-search. No more copying session IDs.

session-ref

Reference another Hermes session by name — no copying session IDs.

Type @session in the Desktop composer and pick from live session suggestions
(or type part of a session's title right after @ and it filters as you
type). Picking inserts a compact reference like @session:"Weekly review"
into your draft.

Spaces in titles: the @ popover stops at the first space (that's the
app's trigger, not this plugin). You don't need to type the full title —
type the first word and pick from the list, e.g. @session:Jev → "Jev
Setup". Typing @session with nothing after it lists your most recent
sessions to choose from.

That reference is not expanded or injected — no session context is copied
into your message. Hermes sees the reference and resolves it with its own
session-search, so it knows exactly which session you mean, and your context
window stays clean.

What it does

  • Registers a composer.atCompletions source (the @ popover) with the
    Hermes Desktop plugin SDK.
  • Session suggestions come from the gateway's session.list RPC — real
    titles, filtered as you type, ordered by relevance then recency.
  • Inserts @session:"<title>" on pick. No autocomplete, no server-side
    expansion, no context injection — reference only, by design.

Install (Desktop app on this machine)

mkdir -p ~/.hermes/desktop-plugins/session-ref
cp desktop/plugin.js ~/.hermes/desktop-plugins/session-ref/plugin.js

Then in the app: ⌘K → Reload desktop plugins. Check no error toast
appears; type @session in any composer to try it.

Install (catalog, once accepted)

hermes plugins install session-ref
hermes plugins enable session-ref

Requirements

  • Hermes Desktop (the app loads the plugin; the CLI/gateway alone does not)
  • Hermes >= 0.21 (the composer.atCompletions SDK seam)

How the agent resolves @session:"<title>"

The reference reaches the agent as literal text. The agent should resolve it
with its session_search tool (read by session id, or discovery by query
matching the title) before answering — and may say it can't find it if the
title was renamed. Titles are unique per Hermes' session-title rules, so a
title reference is unambiguous at the moment it's sent.

Development

# plain JS, no build — edit desktop/plugin.js and reload the app
node --check desktop/plugin.js

License

MIT © kama-dev

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