Skip to content
Maestria

Installation & Setup

@maestria/pi and @maestria/omp are extensions that turn the Pi or Oh My Pi coding agents into disciplined engineering workstations. Each registers 7 specialist subagents, 3 workflow mode commands, and spec-driven orchestration - all with a single extension entry.

Prerequisites

Section titled “Prerequisites”
  • Pi or Oh My Pi (OMP) CLI - the latest version of your chosen coding agent
  • Node.js 22.12+ - Required for npm-based extension resolution

Installation

Section titled “Installation”

Pi

Section titled “Pi”

The recommended approach uses the maestria CLI, which automatically handles peer dependencies:

Terminal window
npx maestria@latest install pi
Alternative: manual Pi CLI setup
Terminal window
# 1. Install the peer dependency for subagent dispatch
pi install npm:@gotgenes/pi-subagents


# 2. Install the extension
pi install npm:@maestria/pi


# 3. Restart Pi for both extensions to load

Oh My Pi

Section titled “Oh My Pi”
Terminal window
omp install @maestria/omp

OMP loads the extension from the package manifest on startup. It auto-discovers the 4 methodology skills and deploys the 7 specialist agent files to ~/.omp/agent/agents/. Restart OMP for the extension to activate.

Verify Installation

Section titled “Verify Installation”

Start a new session with your platform:

Terminal window
# Pi
pi


# OMP
omp

The @maestria/pi or @maestria/omp extension loads automatically from the package manifest. The platform’s resource loader discovers its four methodology skills (orchestrator dispatcher, global agent rules, handoff contract, iteration limits) and injects them into the system prompt.

You should notice the agent behaving as a Maestria dispatcher from the first turn: it responds to requests by decomposing tasks, delegating to specialist subagents, and following the spec-driven orchestration protocol.

You can also list installed extensions to verify:

Terminal window
# Pi
pi extensions list


# OMP
omp extensions list

You should see @maestria/pi or @maestria/omp in the output.

Updating

Section titled “Updating”

Pi

Section titled “Pi”
Terminal window
# Via maestria CLI (recommended)
npx maestria@latest update pi
Terminal window
# Or manually
pi install npm:@maestria/pi@latest

OMP

Section titled “OMP”
Terminal window
omp install @maestria/omp@latest

Uninstalling

Section titled “Uninstalling”

Pi

Section titled “Pi”
Terminal window
# Via maestria CLI
npx maestria@latest uninstall pi

This removes @maestria/pi. The @gotgenes/pi-subagents peer dependency is left in place because other Pi extensions may depend on it.

To remove manually:

Terminal window
# Remove from config and uninstall
pi uninstall @maestria/pi


# Optionally remove peer dependency if not needed by other extensions
pi uninstall @gotgenes/pi-subagents


# Restart Pi

OMP

Section titled “OMP”
Terminal window
omp uninstall @maestria/omp

Restart OMP for the changes to take effect.

Next Steps

Section titled “Next Steps”