Installation & Setup
@maestria/hermes is a git-based Hermes plugin. It adds Maestria skills, workflow commands, lifecycle hooks, and an optional OpenCode routing tool.
Prerequisites
Section titled “Prerequisites”- Hermes Agent
- Git, for plugin resolution from the repository
Install
Section titled “Install”The recommended path uses the Maestria CLI:
npx maestria@latest install hermespnpx maestria@latest install hermesyarn dlx maestria@latest install hermesVerify the native plugin record:
hermes plugins listYou should see maestria-hermes enabled. The equivalent manual installation is:
hermes plugins install agustinusnathaniel/maestria/packages/hermes --enableThe manual command installs the package from the repository and enables it in Hermes.
What the Plugin Adds
Section titled “What the Plugin Adds”| Surface | Contents |
|---|---|
| Skills | 12 skills: 9 methodology skills and 3 workflow-command skills |
| Commands | 7 commands, including /fein, /sonar, /blitz, /mode, /mode-clear, /review, and /plan |
| Hooks | 10 lifecycle hooks for gateway, LLM, tool, session, subagent, and result-transform events |
| Middleware | Optional llm_execution mode-footer annotation, enabled with MAESTRIA_MODE_FOOTER=1 |
| External startup work | None; the plugin does not probe for tools or packages at startup |
The optional opencode_route tool invokes the OpenCode CLI only when you use it. Optional memory providers and Hermes goals remain host features; the plugin does not require either.
Verify a New Session
Section titled “Verify a New Session”Start Hermes and run:
/modeThe response should show the active mode. Ask the agent to list the Maestria specialists, then try one focused task. If the mode marker or skills do not appear, restart Hermes and run hermes plugins list again.
Update
Section titled “Update”npx maestria@latest update hermespnpx maestria@latest update hermesyarn dlx maestria@latest update hermesOr update the native plugin:
hermes plugins update maestria-hermesUninstall
Section titled “Uninstall”hermes plugins remove maestria-hermesThis removes the plugin files and its Hermes registration. Other plugins remain installed.