Skip to content
maestria

Installation & Setup

@maestria/pi adds maestria’s shared methodology to the Pi coding agent as a runtime extension. It registers four specialist subagents, the /fein, /sonar, and /blitz mode commands with /mode-clear, and session commands such as /maestria-status.

Prerequisites

Section titled “Prerequisites”
  • Pi CLI
  • Node.js 22.19+ for npm-based extension resolution
  • @gotgenes/pi-subagents for subagent dispatch

Install

Section titled “Install”
Terminal window
npx maestria@latest install pi

Verify Installation

Section titled “Verify Installation”

Run pi list and confirm @maestria/pi appears. Start a new Pi session and check that the extension loads and exposes the /fein, /sonar, and /blitz commands.

Update

Section titled “Update”
Terminal window
npx maestria@latest update pi

You can also install a specific published version:

Terminal window
pi install npm:@maestria/pi@<version>

Uninstall

Section titled “Uninstall”
Terminal window
npx maestria@latest uninstall pi

If you uninstall manually, the @gotgenes/pi-subagents peer dependency stays installed for other extensions:

Terminal window
pi uninstall npm:@maestria/pi

Remove the peer dependency separately only if no other extension uses it.

Next Steps

Section titled “Next Steps”