# maestria

Maestria ships the same AI engineering methodology to multiple coding agent platforms. Each has its own install commands, update paths, and version management. `maestria` wraps them all behind a single interface, including Claude Code, Codex CLI, and Prime Agent.

## 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 install kimi-code`                | `maestria update kimi-code`          |
| Pi          | `pi install npm:@maestria/pi`               | `pi install npm:@maestria/pi@latest` |
| Prime Agent | `maestria install prime-agent`              | `maestria update prime-agent`        |
| Claude Code | `maestria install claude-code`              | `maestria update claude-code`        |
| Codex CLI   | `maestria install codex`                    | `maestria update codex`              |

With the CLI, one command does it all:

<AllPackageManagers type="dlx" pkg="maestria@latest" args="install --all" />

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

## How It Works

1. **Run <AllPackageManagers type="dlx" pkg="maestria@latest" />** - no install required, thanks to the bundled single-file `.mjs` distribution
2. **Platform detection** - the CLI shows a spinner and checks which supported coding agent CLIs are on your `$PATH`
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

[Getting Started](/cli/getting-started/)
  [Command Reference](/cli/commands/)