c5789f4309
* feat(achievements): share card render on unlocked badges Adds a Share button to each unlocked achievement card that opens a modal and renders a 1200x630 PNG share card client-side via Canvas2D (no backend, no network, no new deps). Two actions: Download PNG and Copy image to clipboard. Card layout mirrors the in-dashboard visual language: tier-colored glow, icon from the existing LUCIDE sprite set, achievement name, tier badge pill, description, progress stat line, and a Hermes Agent watermark. Sized for X/Twitter, Discord, LinkedIn, Bluesky link previews. Vendored on top of the upstream @PCinkusz bundle; the 'in-progress scan banner' precedent already established this divergence pattern. Manifest bumped 0.3.1 -> 0.4.0. * feat(achievements): share-on-X as primary action on share dialog Adds a 'Share on X' button as the primary action in the share dialog. Opens https://x.com/intent/post with a pre-filled tweet referencing the achievement name, tier, @NousResearch, and the Hermes docs URL. Copy image and Download PNG become secondary actions: users who want the badge attached can Copy image, paste into the X composer, post. Primary button styled as X's signature black-on-white fill so the action is unambiguous.
Hermes Achievements
Bundled with Hermes Agent. Originally authored by @PCinkusz at https://github.com/PCinkusz/hermes-achievements — vendored into
plugins/hermes-achievements/so it ships with the dashboard out-of-the-box and stays in lockstep with Hermes feature changes. Upstream repo remains the staging ground for new badges and UI iteration.When Hermes is installed via
pip install hermes-agentor cloned from source, this plugin auto-registers as a dashboard tab on firsthermes dashboardlaunch. No separate install step. See Built-in Plugins → hermes-achievements in the main docs.
Achievement system for the Hermes Dashboard: collectible, tiered badges generated from real local Hermes session history.
The screenshots use temporary demo tier data to show the full visual range. The plugin itself reads real local Hermes session history by default.
Update notice (2026-04-29): If you installed this plugin before today, update to the latest version. The achievements scan path was refactored for much faster warm loads (snapshot cache + incremental checkpoint scan).
Share cards (2026-05-04, vendored in hermes-agent v0.4.0): Unlocked achievement cards now have a "Share" button that renders a 1200×630 PNG share card (client-side canvas, no backend, no network) with Download + Copy-to-clipboard actions. Fits X/Twitter, Discord, LinkedIn, Bluesky link-preview dimensions.
What it does
Hermes Achievements scans local Hermes sessions and unlocks badges based on real agent behavior:
- autonomous tool chains
- debugging and recovery patterns
- vibe-coding file edits
- Hermes-native skills, memory, cron, and plugin usage
- web research and browser automation
- model/provider workflows
- lifestyle patterns such as weekend or night sessions
Achievements have three visible states:
- Unlocked — earned at least one tier
- Discovered — known achievement, progress visible, not earned yet
- Secret — hidden until Hermes detects the first related signal
Most achievements level through:
Copper → Silver → Gold → Diamond → Olympian
Each card has a collapsible What counts section showing the exact tracked metric or requirement once the user wants details.
Version 0.2.x expands the catalog to 60+ achievements, including model/provider badges such as Five-Model Flight, Provider Polyglot, Claude Confidant, Gemini Cartographer, and Open Weights Pilgrim.
Examples
- Let Him Cook
- Toolchain Maxxer
- Red Text Connoisseur
- Port 3000 Is Taken
- This Was Supposed To Be Quick
- One More Small Change
- Skillsmith
- Memory Keeper
- Context Dragon
- Plugin Goblin
- Rabbit Hole Certified
Install
Clone into your Hermes plugins directory:
git clone https://github.com/PCinkusz/hermes-achievements ~/.hermes/plugins/hermes-achievements
For local development, keep the repo elsewhere and symlink it:
git clone https://github.com/PCinkusz/hermes-achievements ~/hermes-achievements
ln -s ~/hermes-achievements ~/.hermes/plugins/hermes-achievements
Then rescan dashboard plugins:
curl http://127.0.0.1:9119/api/dashboard/plugins/rescan
If backend API routes 404, restart hermes dashboard; plugin APIs are mounted at dashboard startup.
Updating
If you installed with git:
cd ~/.hermes/plugins/hermes-achievements
git pull --ff-only
curl http://127.0.0.1:9119/api/dashboard/plugins/rescan
If the update changes backend routes or plugin_api.py, restart hermes dashboard after pulling.
As of 2026-04-29, updating is strongly recommended because scan performance changed significantly:
- removed duplicate
/overviewscan path - added cached
/achievementssnapshot - added incremental checkpoint reuse for unchanged sessions
Achievement unlock state is stored locally in state.json and is not overwritten by git updates. New achievements are evaluated from your existing Hermes session history. Achievement IDs are stable and should not be renamed casually because they are the unlock-state keys.
Releases are tagged in git, for example:
git fetch --tags
git checkout v0.2.0
Files
dashboard/
├── manifest.json
├── plugin_api.py
└── dist/
├── index.js
└── style.css
API
Routes are mounted under:
/api/plugins/hermes-achievements/
Endpoints:
GET /achievements
GET /scan-status
GET /recent-unlocks
GET /sessions/{session_id}/badges
POST /rescan
POST /reset-state
Development
Run checks:
node --check dashboard/dist/index.js
python3 -m py_compile dashboard/plugin_api.py
python3 -m unittest tests/test_achievement_engine.py -v
License
MIT