hermes-desktop-pluginslisted
Install: claude install-skill 988hj7tczd-oss/skill-tool
# Hermes Desktop Plugins Skill
Write plugins for the Hermes desktop app: statusbar items, layout panes,
command-palette commands, keybinds, routes, and themes. A plugin is a single
plain-JavaScript ESM file the app loads at runtime — no build step, no repo
changes. A plugin can also talk to its own Python backend namespace
(`ctx.rest`/`ctx.socket` → `/api/plugins/<id>`); the general Python plugin
system (`~/.hermes/plugins/`) is otherwise documented separately.
Full human reference (every export, area payloads, backend, security):
`website/docs/developer-guide/desktop-plugin-sdk.md`.
## When to Use
- The user asks for a new desktop UI element (a pane, a statusbar widget, a
dashboard, a command) without modifying the app itself.
- You want to surface data you compute (via gateway RPC) inside the app.
## Prerequisites
- The Hermes desktop app (it loads plugins; the CLI/gateway alone does not).
- Write access to `$HERMES_HOME/desktop-plugins/` (usually
`~/.hermes/desktop-plugins/`).
## How to Run
1. Create `$HERMES_HOME/desktop-plugins/<name>/plugin.js` from
`templates/plugin.js` (relative to this skill directory) — that's
`~/.hermes/...` by default, or `~/.hermes/profiles/<profile>/...` under a
named profile. Keep `<name>` equal to the plugin `id`.
2. The desktop app watches that directory: the plugin loads within a few
seconds of the file landing, and every later save hot-reloads it in
place. No reload step. (Fallback if it doesn't appear: ⌘K →
**