Skip to content
Maestria

One CLI to Manage Them All

Install, update, and check maestria across coding agent platforms. Configure per-agent models for OpenCode, Pi, and OMP from the same command.
Get StartedCommand Reference

Maestria ships the same AI engineering methodology to three coding agent platforms. Each has its own install commands, update paths, and version management. maestria wraps them all behind a single interface.

Why a CLI?

Section titled “Why a CLI?”

Without the CLI, managing maestria means remembering per-platform commands:

Platform Install Update
OpenCode opencode plugin @maestria/opencode@latest Re-run with --force
Kimi Code maestria update kimi-code Re-run the update command
Pi pi install npm:@maestria/pi pi install npm:@maestria/pi@latest

With the CLI, one command does it all:

Terminal window
npx maestria@latest install --all

No more context-switching between platform CLIs. No more hunting through READMEs for the right command.

How It Works

Section titled “How It Works”
  1. Run
    Terminal window
    npx maestria@latest
     - no install required, thanks to the bundled single-file .mjs distribution
  2. Platform detection - the CLI shows a spinner and checks which coding agent CLIs are on your $PATH (opencode, kimi, pi)
  3. Parallel checks - for each detected platform, it checks whether maestria is installed and what version is available
  4. Action - install, update, configure per-agent models, or inspect as needed

All commands support --json for script consumption and --quiet to suppress spinner animations for CI environments.

Explore the Docs

Section titled “Explore the Docs”
Getting StartedInstallation and common usage patterns - status checks, installs, updates, and per-agent model config.
Command ReferenceFull reference for status, install, update, and configure commands with flags.