@maestria/opencode

@MAESTRIA/OPENCODE

An orchestrator and seven specialists.

Install one plugin to add 8 agents, shared workflow rules, and session-aware orchestration to OpenCode.

Get started Configuration

npx maestria install opencode

npm · pnpm · yarn · bun · deno
- any runtime works

01WHAT YOU GET

One plugin, the whole harness.

8 specialized agents

The orchestrator plus seven specialists - adventurer, architect, builder, diagnose, planner, reviewer, writer - registered programmatically when the plugin loads.

Global rules every session

Workflow directives are appended to every OpenCode session automatically. No prompt engineering, no forgotten context.

Delegate with @ mentions

All 8 agents work as subagents. Call any specialist directly - @adventurer for recon, @builder for implementation, @reviewer for an independent check.

Session state preserved

A compaction hook remembers task status, so long-running work survives context resets.

Per-agent model control

Agents register without model overrides. Assign models per agent from your own config whenever you have a reason to.

Native tool permissions

Each agent ships its own permission fields, honored by OpenCode's V2 runtime - read-only reviewers stay read-only.

02HOW IT WIRES IN

Self-registering, start to finish.

1
Plugin loads - OpenCode installs @maestria/opencode from npm
2
Config hook - reads bundled agent .md files, parses frontmatter, registers them programmatically
3
Rules injected - global workflow directives appended to every session
4
Agents available - all 8 agents are available as subagents via @ mention
5
State preserved - session compaction hook remembers task status

03INSTALL PATHS

Three installation paths.

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

opencode plugin @maestria/opencode@latest -g

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

{
  "plugin": ["@maestria/opencode@latest"],
}

04FIND YOUR WAY

Start with the plugin.

Getting StartedInstallation, setup, and your first session with the plugin.ConfigurationPer-agent models and OpenCode-level settings.Agent ReferenceRoles, permissions, and when to use each of the 8 agents.Workflow PatternsPractical agent usage patterns - from recon to full build pipelines.ReferenceTool permissions, t3code compatibility, and known limitations.ChangelogVersion history and release notes.ContributingDevelopment setup, project structure, and how to extend the plugin.

SAME METHOD · OTHER PLATFORMS