Portable Engineering Workflows

The same Maestria methodology that works on OpenCode is adapted for Pi and Oh My Pi (OMP). The role names and workflow ideas carry over, but runtime behavior is not identical. Dispatch, tool enforcement, context inheritance, mode activation, and compaction are platform-specific. Read When to use Maestria before assuming that a workflow transfers unchanged.

Tip

Pi uses @gotgenes/pi-subagents for subagent dispatch via the maestria_subagent tool. OMP has built-in task() dispatch - no external dependency needed.

How It Works

1. Install the extension - one command for your platform
2. Extension activates - deploys 7 specialist agent files, auto-discovers methodology skills, registers mode commands (/fein, /sonar, /blitz)
3. Mode commands drive the pipeline - /fein (full pipeline), /sonar (research), /blitz (fast impl) - each activates the right subagents in sequence
4. Orchestrator dispatches - decomposes work, delegates to specialists via subagent dispatch (Pi or OMP), enforces phase gates
5. Session tree tracks state - each subagent invocation records its parent task ID, preserving the full session tree across turns

Quick Install

npm

# Pi
npx maestria@latest install pi

pnpm

# Pi
pnpx maestria@latest install pi

yarn

# Pi
yarn dlx maestria@latest install pi

# Oh My Pi
omp install @maestria/omp

Both extensions are fully self-configuring - no manual config editing needed.

OMP native goal state is observed in Maestria’s session mirror. Active, paused, and budget-limited goals are shown; complete and dropped terminal events clear the current-goal mirror. Session transitions rehydrate target-session Maestria state and use OMP’s public native goal entry when available; otherwise the mirror remains unknown until a public goal event. User-issued /goal commands remain OMP-owned, while model goal calls are blocked when their provenance is unavailable.

Installation Guide →

Platform Comparison

Feature	Pi	OMP
Subagent dispatch	@gotgenes/pi-subagents extension	Built-in task() tool
Dispatch tool	maestria_subagent(agent, task)	task(agent, task) or maestria_subagent(...)
Peer dependency	@gotgenes/pi-subagents	None
Enforcement tools	maestria_subagent only	task and maestria_subagent
Agent discovery dir	~/.pi/agent/agents/	~/.omp/agent/agents/
Install command	pnpx maestria@latest install pi	omp install @maestria/omp

Explore the Docs

Getting StartedInstallation, setup, and your first session.

ReferenceCommands, subagent dispatch, review mode, and session management.

ChangelogVersion history and release notes.

ContributingProject structure and how to extend.