Skip to content
maestria

Installation & Setup

@maestria/pi and @maestria/omp add the maestria methodology to the Pi and Oh My Pi coding agents. Each installs as one extension and registers 7 specialist subagents, 3 workflow mode commands, and spec-driven orchestration.

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”

The maestria CLI installs the extension and its peer dependency:

Terminal window
npx maestria@latest install pi

Verify Installation

Section titled “Verify Installation”

  1. Start your platform:

    Terminal window
    pi

    Expected: the extension loads automatically, and the agent dispatches from the first turn, decomposing tasks and delegating to specialists.

  2. List what’s installed:

    Terminal window
    pi list

    Expected: @maestria/pi or @maestria/omp appears in the output.

Updating

Section titled “Updating”
Terminal window
# Pi (via maestria CLI)
npx maestria@latest update pi
Terminal window
pi install npm:@maestria/pi@latest


# Or pin a version
pi install npm:@maestria/pi@<version>

Version history is in the changelog.

Uninstalling

Section titled “Uninstalling”
Terminal window
# Pi (via maestria CLI)
npx maestria@latest uninstall pi
Terminal window
# The @gotgenes/pi-subagents peer dependency stays for other extensions
pi uninstall npm:@maestria/pi


# Optional: remove the peer dependency if no other extension needs it
pi uninstall npm:@gotgenes/pi-subagents

Restart your platform after updating or uninstalling.

Next Steps

Section titled “Next Steps”
  • Quick Start - Your first session with the extension
  • Reference - Commands, dispatch, and review mode