ai-agent-orchestrator

ai-agent-orchestrator

ai-agent-orchestrator запускает Codex, Claude Code, Cline и другие coding-agent runtimes как внешние процессы через versioned CLI и MCP contracts.

Установка

python -m pip install "ai-agent-orchestrator[mcp]"

Требуются Python 3.11 или новее, Linux, Git и Bubblewrap. Runtime CLI устанавливаются отдельно. Authentication может принадлежать runtime либо задаваться literal environment values в user-global/ignored local orchestrator config; job artifacts и public results credential values не хранят.

Начало работы

ai-agents --workspace /path/to/repository init
ai-agents --workspace /path/to/repository check
ai-agents --workspace /path/to/repository run --task task.json

init создаёт отсутствующие consumer-owned bootstrap files и создаёт либо обновляет package-managed instructions в .ai-agents/docs/. Он не перезаписывает AGENTS.md, config или shared instructions. check не выполняет provider call без explicit --live. Retained isolated worktrees удаляются только через dry-run-first prune и explicit --apply.

Task v3 объявляет external resources только через semantic capabilities. Consumer-owned role/profile выбирает exact binding, а resource values существуют только в памяти supervisor и scoped child environment. Provider-specific transport_profile отделён от task tools; unsupported runtime/version combinations завершаются fail closed до чтения provider values. Текущий scoped baseline доказан для exact codex-cli 0.147.0.

Local MCP server привязан к одному meta-workspace:

ai-agents-mcp --workspace /absolute/path/to/meta-workspace

Для полного делегирования consumer agent вызывает MCP delegate(task_path) один раз и получает terminal bounded result без промежуточного polling. init материализует subagent usage и subagent creation в .ai-agents/docs/ и обновляет их до exact copies установленного package.

Полные contracts, configuration examples, host setup, upgrade и rollback procedures находятся в репозитории проекта.

Consumer configuration изменяется командой configure: preview не пишет файлы, а apply требует точный --expect-source-sha256 HASH|absent из preview.

Лицензия

MIT. Copyright (c) 2026 belkovrv.