VGFreakXBL GitHub avatar

hermes-sticky-notes

VGFreakXBL

Hermes Sticky Notes is a lightweight plugin for Hermes Desktop that adds stackable, break-out, and pile-able sticky notes (post-it notes) directly on the desktop glass.

Stars

12

7-day growth

No data

Forks

0

Open issues

0

License

MIT

Last updated

2026-07-29

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It provides a polished sticky-note experience inside the Hermes Desktop environment without requiring a fork or build step, using the plugin SDK and CSS variables for theming, and offers unique interactions like dragging notes to pile them together.

Who it is for

  • Hermes Desktop users who need quick note-taking on their desktop
  • Knowledge workers or researchers who use Hermes as an agent interface
  • Developers exploring the Hermes plugin ecosystem
  • Anyone who wants a visually minimal, keyboard-accessible sticky note system

Use cases

  • Jotting down quick reminders, ideas, or tasks while working in Hermes Desktop
  • Organizing notes by stacking them, then breaking out important ones for visibility
  • Piling related notes together by dragging them to overlap, for brainstorming sessions
  • Using experimental agent commands (e.g., /sticky) to create notes from plain text

Strengths

  • Zero setup: single-file plugin with no build step or app fork required
  • Flexible interaction model: stack, break out, pile, and stack all with keyboard shortcuts
  • Theme-aware: uses app CSS variables instead of hardcoded colors
  • Profile-aware storage via plugin-scoped ctx.storage, respecting Hermes profiles

Considerations

  • v0.1 — global stickies by default; session pin is light, project pin not yet implemented
  • Agent authoring (plain text markers) is experimental and best-effort
  • Requires Hermes Desktop (Electron app); CLI/gateway alone does not load the plugin
  • Disk plugin constraints limit imports to react, react/jsx-runtime, and the plugin SDK

README quick start

Hermes Sticky Notes

In-Desktop sticky / post-it notes for Hermes Desktop, built as a single disk plugin (no app fork, no build step).

One stack on the glass. Break out notes when they need ambient space. Drag floats together to pile them. Stack all when the desk gets loud.

v0.1 — global stickies by default. Session pin exists as a light toggle; project pin may come later.

Install

Requires Hermes Desktop (the Electron app). CLI/gateway alone will not load this.

mkdir -p ~/.hermes/desktop-plugins/sticky-notes
curl -fsSL -o ~/.hermes/desktop-plugins/sticky-notes/plugin.js \
  https://raw.githubusercontent.com/VGFreakXBL/hermes-sticky-notes/main/plugin.js

Or copy manually:

mkdir -p ~/.hermes/desktop-plugins/sticky-notes
cp plugin.js ~/.hermes/desktop-plugins/sticky-notes/plugin.js

Then in Desktop:

  1. ⌘K → Reload desktop plugins (or wait a few seconds for the file watcher)
  2. Settings → Plugins → enable Sticky Notes if it’s off
  3. Look for the status chip sticky and the floating stickies stack card

Named profiles: install under ~/.hermes/profiles//desktop-plugins/sticky-notes/ instead when that profile is active.

How to use

ActionHow
New stickyStatus chip, stack New, palette Sticky: New (stack), or ⌘⇧N
EditSelect a row in the stack; body autosaves
Break out on a stack row or Break out in the editor
PileDrag free breakout windows until they overlap ~40%, then release
Flip inside a pileClick a row in the pile list
Split from pile on a pile row
Return one to stack↙ stack on a breakout, or in a pile
Stack everythingStack all / ⌘⇧S / palette
Clear allPalette Sticky: Clear all (destructive)

Notes persist in plugin-scoped storage (ctx.storage), profile-aware. No real filesystem access.

Design notes

  • One stack card by default (not one float per note)
  • Overlap-merge only after a real drag (not on plain clicks)
  • Short grace after split so notes aren’t immediately re-piled
  • Themes: no hardcoded colors — uses app CSS variables
  • Disk plugin rules: jsx() / jsxs() only; imports limited to @hermes/plugin-sdk, react, react/jsx-runtime

Agent (best-effort)

If the gateway event payload in

Description

Sticky / post-it notes for Hermes Desktop (disk plugin)

Related repositories

Similar projects matched by category, topics, and programming language.

Blaizzy
Featured
Blaizzy GitHub avatar

nativ

Nativ is a native macOS app that lets you run AI models locally on Apple silicon, offering chat, model management, performance analytics, and an OpenAI/Anthropic-compatible API server.

AI & Machine LearningAI Vision & Audio
985
makecindy
Featured
makecindy GitHub avatar

cindy

Cindy is an open-source AI agent that runs locally on your machine, integrates multiple AI harnesses and models, and provides memory, skills, and automation to perform real work in your projects and apps.

AI & Machine LearningLarge Language Models
958
mereyabdenbekuly-ctrl
Featured
mereyabdenbekuly-ctrl GitHub avatar

clodex-ide

Clodex is an open-source, local-first agentic IDE that combines persistent AI tasks, code, terminal, browser, Git, models, memory, and governed execution in one Electron workspace, currently in technical preview.

AI & Machine LearningAI Agents
859