Hermes Desktop Achievements

Achievements, right inside the Hermes desktop app, with unlock notifications.

A full achievements page (score header, tier filters, progress bars, rescan),
a sidebar nav row, a live statusbar score chip, and a ⌘K command — all backed
by the hermes-achievements dashboard plugin that ships with Hermes Agent.

What you get

• Unlock notifications — toast, haptic, a chime, and a confetti burst in
  your theme colors plus the badge's tier color, no page visit required
• Discord announcements — optional webhook posts every unlock and
  milestone to your server
• Tier-specific sounds — Copper/Silver get the chime, Gold and up and
  milestones get a five-note fanfare
• Score header — unlocked/total, discovered/secret counts, scan freshness,
  one-click Rescan
• Next up strip — the locked achievements closest to unlocking, with
  progress bars and next-tier thresholds
• Unlock history — a chronological timeline of every unlock with dates and
  evidence sessions
• Custom achievements — define your own personal badges, mark them done,
  get the same celebration
• Settings panel — toggles for confetti, sound, haptic, and the Discord
  webhook URL, persisted across restarts
• Milestone celebrations — a bigger confetti party at every 10 unlocks
• Weekly mini-stats — unlocks this week, busiest day, tier counts
• Export badges — download the full list as Markdown or JSON
• Replay celebrations — fire the confetti again from any unlocked badge or
  history entry
• Per-session context — badges earned in the active session, right on the
  page
• Share cards — 1200×630 canvas PNG export for any unlocked badge, ready
  to post
• Filter tabs — all / unlocked / discovered / secret / history / custom
  with live counts
• Search and sort — filter by name, sort by closest, tier, or name
• NEW freshness tag — badges unlocked in the last 48 hours are marked NEW
• Statusbar chip — live score plus the closest next-up achievement in the
  tooltip; click to open
• Command palette — ⌘K → "Achievements: Open"

Install

1. Backend (required): the Hermes Agent install already ships
   plugins/hermes-achievements/ (it mounts /api/plugins/hermes-achievements/
   on hermes serve). Make sure it's enabled in ~/.hermes/config.yaml:

   plugins:
     enabled:
       - hermes-achievements
   

   Verify it mounted:

   grep "Mounted plugin API routes: /api/plugins/hermes-achievements" ~/.hermes/logs/agent.log
   

2. Desktop plugin: copy the folder into your desktop plugins directory:

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

3. The app watches that directory — the plugin loads within a few seconds.
   If it doesn't appear: ⌘K → Reload desktop plugins.

Requirements

• Hermes Agent desktop app (v0.19+ recommended)
• The hermes-achievements plugin enabled (bundled with Hermes Agent; see
  plugins/hermes-achievements/ in the repo or the dashboard's built-in
  plugins doc)

How it works

• Zero new backend. The plugin talks to the existing
  hermes-achievements dashboard plugin API over ctx.rest →
  /api/plugins/hermes-achievements/achievements — the same scan engine the
  web dashboard uses.
• Unlock watcher. Polls /achievements every 15 seconds and diffs against
  a known-unlock set persisted in plugin storage. First load seeds the
  baseline, so restarts never replay old unlocks. New unlocks fire a success
  toast, haptic, and a two-tone chime, then invalidate the shared React Query
  cache.
• Theme-native. Cards, chips, and the share card use the app's theme CSS
  variables, no hardcoded colors, follows light/dark.

Files

plugin.js   The whole plugin — plain ESM, loaded uncompiled (jsx() calls, no JSX syntax)

Development

The desktop plugin SDK docs live in the Hermes Agent repo:
website/docs/developer-guide/desktop-plugin-sdk.md.

Quick iteration loop: edit plugin.js, save — the app hot-reloads in place.

License

MIT. Original plugin by Tony Simons, extended by
Cliff Wade with unlock notifications, next-up
tracking, per-session badges, and share cards.