Skip to content
maestria

Installation & Setup

@maestria/hermes is a git-based Hermes plugin. It adds 12 skills (9 methodology plus 3 command skills), 5 slash commands, and 9 lifecycle hooks, plus the opencode_route tool, which invokes the OpenCode CLI only when you use it.

Prerequisites

Section titled “Prerequisites”
  • Hermes Agent
  • Git, for plugin resolution from the repository

Install

Section titled “Install”

  1. Install through the maestria CLI:

    Terminal window
    npx maestria@latest install hermes

    Or install directly with Hermes, which clones the repository and enables the plugin:

    Terminal window
    hermes plugins install agustinusnathaniel/maestria/packages/hermes --enable

  2. Verify the native plugin record:

    Terminal window
    hermes plugins list

    maestria-hermes should appear as enabled.

Verify a New Session

Section titled “Verify a New Session”

Start Hermes and run:

/mode

The 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 are missing, restart Hermes and run hermes plugins list again.

Update

Section titled “Update”
Terminal window
npx maestria@latest update hermes

Or update the native plugin: hermes plugins update maestria-hermes.

Uninstall

Section titled “Uninstall”
Terminal window
hermes plugins remove maestria-hermes

Next Steps

Section titled “Next Steps”