Hermes Labyrinth
stainlu/hermes-labyrinth
Read-only observability dashboard plugin for Hermes Agent that maps journeys, tool calls and failures
Hermes Labyrinth is a read-only observability plugin for the Hermes Agent dashboard. It turns agent work such as prompts, tool calls, failures, subagents and cron runs into a map of crossings with exportable, redacted reports.
What Hermes Labyrinth does
Hermes Labyrinth describes itself as a black-box recorder rather than a chat UI. It reads local Hermes state through Hermes dashboard plugin routes and lists recent CLI, dashboard, gateway, cron and delegated work as a journey index. Selecting a journey opens a map of ordered crossings: prompts, tool calls and results, failures, model switches, subagents, approvals, memory hits, redactions, context compression and cron runs.
An inspector shows input, output, duration, status and evidence for each crossing, and guideposts add generated observations backed by local evidence. Other views cover a skill atlas with shadowed overrides and duplicate diagnostics, a cron gate with next runs and last failures, and a model ferry for provider transitions. The plugin is read-only by design. It never starts, stops or mutates Hermes sessions, and it shows [redaction unavailable] instead of raw text if the Hermes redactor cannot load.
Key features
- Journey index of recent CLI, dashboard, gateway, cron and delegated work
- Ordered map of crossings with an inspector for input, output, duration and status
- Skill atlas showing shadowed overrides and duplicate skills
- Cron gate with next runs, last failures and workdirs
- Model ferry showing model and provider transitions across sessions
- Redacted Markdown and JSON reports for one journey
When to use it
- Reviewing what a long autonomous Hermes run actually did, step by step
- Finding which cron job failed last and why
- Exporting a redacted report of one agent journey to share with a teammate
- Auditing which skills are overridden or duplicated
Who it is for: Hermes Agent users who run autonomous, scheduled or delegated work and want a read-only view of what the agent did.
How it fits with Hermes Agent
Built for Hermes Agent as a dashboard plugin. It installs into the Hermes user plugin directory and adds a Labyrinth tab to the Hermes dashboard.
How to install Hermes Labyrinth
These commands are copied from the project's README. Check the repository for the latest steps before you run them.
mkdir -p ~/.hermes/plugins
git clone https://github.com/stainlu/hermes-labyrinth.git ~/.hermes/plugins/hermes-labyrinth
hermes dashboardRequirements: A Hermes Agent installation with the Hermes dashboard
Note: The public GitHub Pages demo is static and uses mocked Hermes state, so it is not live telemetry.
FAQ
What is Hermes Labyrinth?
Hermes Labyrinth is a read-only observability plugin for the Hermes Agent dashboard. It maps an agent's prompts, tool calls, failures and cron runs as journeys and exports redacted reports.
Does Hermes Labyrinth work with Hermes Agent?
Yes, it is built for Hermes Agent. It reads local Hermes state through the dashboard plugin routes and appears as a Labyrinth tab once the dashboard is started.
How do I install Hermes Labyrinth?
Clone the repository into ~/.hermes/plugins/hermes-labyrinth and start the dashboard with hermes dashboard. If the dashboard was already running, the README says to stop and restart it fully after a first install.
Similar plugins for Hermes Agent
All plugins23 plugins for hermes-agent covering autonomy, observability, cost control, safety and memory
robbyczgw-cla Web Search PlusHermes plugin for multi-provider web search and clean page extraction with automatic fallback
ogallotti rtk-hermesHermes Agent plugin that rewrites shell commands through RTK to cut tokens in tool output
Humalike Humalike PluginHermes Agent plugin that adds turn-taking, persona and social learning for group chats
allmodels-io Hermes SpeechHermes Agent plugin that adds AllModels text-to-speech and speech-to-text with voice search
thomasbek3 Hermes Bot KitHermes Desktop plugins for iMessage-style chat bubbles, a live bot computer pane and roster sections
Related guides: How to install Hermes Agent · How to run Hermes Agent securely