One CLI to Manage Them All
Install, update, and check the status of maestria plugins across OpenCode, Kimi Code, and Pi - from a single command.
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:
npx maestria install --allNo more context-switching between platform CLIs. No more hunting through READMEs for the right command.
How It Works
Section titled “How It Works”- Run
npx maestria- no install required, thanks to the bundled single-file.mjsdistribution - Platform detection - the CLI shows a spinner and checks which coding agent CLIs are on your
$PATH(opencode, kimi, pi) - Parallel checks - for each detected platform, it checks whether maestria is installed and what version is available
- Action - install, update, 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, and updates.
Command ReferenceFull reference for status, install, and update commands with flags.