# maestro-orchestrate

> Multi-agent orchestration platform for Gemini CLI and Claude Code — 22 specialists, parallel subagents, persistent sessions, and built-in code review, debugging, security, SEO, accessibility, and comp

- **URL**: https://www.freshcrate.ai/projects/maestro-orchestrate
- **Author**: josstei
- **Category**: AI Agents
- **Latest version**: `v1.6.4` (2026-04-30)
- **License**: Apache-2.0
- **Source**: https://github.com/josstei/maestro-orchestrate
- **Homepage**: https://josstei.github.io/maestro-orchestrate/
- **Language**: JavaScript
- **GitHub**: 361 stars, 19 forks
- **Registry**: github
- **Tags**: `agentic`, `ai-agents`, `ai-coding`, `ai-tooling`, `anthropic`, `claude`, `claude-code`, `claude-code-plugin`, `javascript`

## Description

Multi-agent orchestration platform for Gemini CLI and Claude Code — 22 specialists, parallel subagents, persistent sessions, and built-in code review, debugging, security, SEO, accessibility, and compliance tools

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v1.6.4` | 2026-04-30 | High | ### Added  - **Maestro cheatsheet**: added an English quick-reference guide covering supported runtimes, common commands, workflow concepts, and suggested reading order.  ### Changed  - **npm package identity**: renamed the planned npm package to `@josstei/maestro`, added `hello@josstei.dev` to public author metadata, and moved the stable release publish path into GitHub Actions with npm token authentication.  ### Fixed  - **Stable npm release recovery**: Release now uses `NPM_TOKEN` for stable |
| `v1.6.3` | 2026-04-21 | High | ### Added  - **5 new MCP tools** (Session pack 5 → 10; total pack count 12 → 17):   - `enter_design_gate`, `record_design_approval`, `get_design_gate_status` — server-side design-gate lifecycle; `create_session` now enforces approval before session creation   - `scan_phase_changes`, `reconcile_phase` — post-hoc phase reconciliation when an agent's actual file manifest diverges from the plan - **17 additional specialist agents** — Expanded the roster from 22 to 39 specialists:   - **ML / AI**: ` |
| `v1.6.2` | 2026-04-15 | High | ### Added  - **Qwen Code runtime support** (#26) — Fourth runtime target with hook adapter, extension manifest (`qwen-extension.json`), context file (`QWEN.md`), 22 agent stubs, and `hooks.json` for `SubagentStart`/`SubagentStop` lifecycle events - **`getExitCode(result)` adapter contract** (#42) — Each hook adapter now owns its exit code semantics; shared `exit-codes.js` constants (`EXIT_SUCCESS`, `EXIT_BLOCK`) verified against Gemini CLI, Claude Code, and Codex CLI source - **npm publishing w |
| `v1.6.1` | 2026-04-10 | High | ### Added  - **Self-contained Claude runtime payload** (`src/manifest.js`) — Added `'claude'` to the self-contained runtime payload manifest rule (already used by Codex) so the full `src/` tree is bundled into `claude/src/`; canonical-source resolution now succeeds from plugin caches outside the repo tree - **`withIsolatedClaudePlugin` test helper** (`tests/integration/helpers.js`) — Copies the generated `claude/` directory into an isolated temp directory for testing plugin behavior outside the |
| `v1.6.0` | 2026-04-10 | Medium | ### Added  - **Codex runtime target** (`plugins/maestro/`) — Complete third runtime for OpenAI Codex with plugin manifest, 22 agent stubs, 19 skills, MCP entry-point, and runtime guide; agents use kebab-case names and `spawn_agent(...)` delegation - **Canonical source architecture** — Single `src/` tree serves all three runtimes (Gemini, Claude, Codex) via `requireFromCanonicalSrc()` dynamic resolution, eliminating verbatim lib copies and runtime-specific source directories - **`get_agent` MCP |
| `v1.5.0` | 2026-04-04 | High | ### Added  - **`get_skill_content` MCP tool** — Reads delegation protocols, templates, and reference documents by identifier via MCP, bypassing workspace sandbox restrictions. Used by the orchestrate command to load non-skill resources (methodology skills are loaded via `activate_skill`). - **`references/orchestration-steps.md`** — Shared numbered-step sequence (40 steps with inline HARD-GATEs) loaded by both Gemini CLI and Claude Code orchestrate commands as the sole procedural authority. - ** |
| `v1.4.0` | 2026-03-19 | Low | ### Added  - **10 new specialist agents** — `seo_specialist`, `copywriter`, `content_strategist`, `ux_designer`, `accessibility_specialist`, `product_manager`, `analytics_engineer`, `i18n_specialist`, `design_system_engineer`, `compliance_reviewer`; roster expanded from 12 to 22 - **MCP server** (`mcp/maestro-server.js`) — Bundled Model Context Protocol server registered via `mcpServers` in `gemini-extension.json` with 9 tools: `initialize_workspace`, `assess_task_complexity`, `validate_plan`, |
| `v1.3.0` | 2026-03-07 | Low | ### Added  - **Plan-based execution mode recommendation** — When `MAESTRO_EXECUTION_MODE=ask` (default), the orchestrator analyzes the implementation plan's dependency graph and presents a data-driven parallel vs sequential recommendation via `ask_user` - **Execution mode gate enforcement** — `<HARD-GATE>` language in the execution skill ensures the mode prompt cannot be skipped; safety fallback stops delegation if `execution_mode` is missing from session state - **Mandatory gate references acr |
| `v1.2.1` | 2026-02-23 | Low | ### Added  - **Expanded test coverage** — Added 91 unit tests and migrated integration tests to Node.js to validate hooks, dispatch, state handling, config resolution, and timeout behavior - **Cross-platform PR CI matrix** — Added GitHub Actions workflow (`.github/workflows/ci.yml`) running `node tests/run-all.js` on both `ubuntu-latest` and `windows-latest`  ### Changed  - **Cross-platform runtime migration** — Replaced bash/Python hook and script execution paths with Node.js entry points for |
| `v1.2.0` | 2026-02-19 | Low | ### Added  - **Hooks-based lifecycle middleware** — BeforeAgent and AfterAgent hooks with shared shell library (`hooks/lib/common.sh`), `safe_main` wrapper for guaranteed JSON output, and advisory error handling - **Agent tracking** — BeforeAgent/AfterAgent hooks track active agent identity via `/tmp/maestro-hooks/<session-id>/active-agent`; lazy state creation on first write, stale-pruned during BeforeAgent - **Handoff report validation** — AfterAgent hook validates delegated agent output i |

## Citation

- HTML: https://www.freshcrate.ai/projects/maestro-orchestrate
- Markdown: https://www.freshcrate.ai/projects/maestro-orchestrate.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/maestro-orchestrate/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._