# @maestria/opencode
  1. 1

    Plugin loads - OpenCode installs @maestria/opencode from npm

  2. 2

    Config hook - reads bundled agent .md files, parses frontmatter, registers them programmatically

  3. 3

    Rules injected - global workflow directives appended to every session

  4. 4

    Agents available - all 8 agents are available as subagents via @ mention

  5. 5

    State preserved - session compaction hook remembers task status

The chip above uses the maestria CLI. Prefer native tooling? Install straight through OpenCode:

```bash opencode plugin @maestria/opencode@latest -g ```

Or add it to your OpenCode config manually (~/.config/opencode/opencode.jsonc):

```jsonc { "plugin": ["@maestria/opencode@latest"], } ```
Getting Started Installation, setup, and your first session with the plugin. Configuration Per-agent models and OpenCode-level settings. Agent Reference Roles, permissions, and when to use each of the 8 agents. Workflow Patterns Practical agent usage patterns - from recon to full build pipelines. Reference Tool permissions, t3code compatibility, and known limitations. Changelog Version history and release notes. Contributing Development setup, project structure, and how to extend the plugin.