Oh My Claude Code — оркестрация нескольких AI-агентов для Claude Code

Oh My Claude Code (OMC) — open-source plugin и terminal CLI для Claude Code, который превращает обычную агентную сессию в управляемый multi-agent workflow. Проект не позиционируется как отдельный coding agent: он добавляет к Claude Code слой оркестрации, набор специализированных агентов, skills, hooks и локальное состояние.

Главная идея — не заставлять пользователя вручную подбирать агента для каждой задачи. OMC принимает описание работы, активирует подходящий workflow, распределяет её между специалистами и сохраняет результаты так, чтобы длинная задача не потерялась после смены контекста.

Две поверхности

OMC предоставляет два разных интерфейса. Они решают разные задачи и не взаимозаменяемы.

Plugin предоставляет in-session skills, hooks, агентов и statusline. CLI нужен для установки, обновления, диагностики, запуска внешних advisors, работы с tmux-командами и автоматизации. Например, в CI следует использовать детерминированные CLI-операции, а не интерактивные slash-команды, которым нужна активная Claude Code session.

Установка и настройка

Для большинства пользователей рекомендован plugin через marketplace. Две команды нужно вводить по одной:

/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
/plugin install oh-my-claudecode

Альтернативный путь устанавливает npm-пакет и CLI. В репозитории и plugin используется имя oh-my-claudecode, а опубликованный npm-пакет называется oh-my-claude-sisyphus:

npm i -g oh-my-claude-sisyphus@latest
omc setup

После установки настройка выполняется из сессии или из терминала:

# Внутри Claude Code
/omc-setup

# Из терминала
omc setup

Минимальный запуск задачи выглядит так:

/autopilot "build a REST API for managing tasks"

Team Mode

Начиная с v4.1.7, Team — основной способ координировать параллельную работу. Внутри Claude Code его запускают явно:

/team 3:executor "fix all TypeScript errors"

Team проходит через стадии:

team-plan → team-prd → team-exec → team-verify → team-fix

На стадии team-plan команда уточняет объём работы, затем формирует PRD или технический план. На team-exec агенты реализуют изменения, после чего team-verify проверяет результат, а team-fix возвращает задачу на исправление, если проверка не пройдена. Включить native Claude Code teams можно переменной:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

У omc team есть отдельный terminal runtime. Он запускает настоящие CLI-процессы в tmux-панелях:

omc team 2:codex "review auth module for security issues"
omc team 2:gemini "redesign UI components for accessibility"
omc team 2:antigravity "redesign UI components for accessibility"
omc team 1:claude "implement the payment flow"
omc team 1:cursor "implement the payment flow"
omc team status auth-review
omc team shutdown auth-review

Поддерживаемые worker-типы включают Claude, Codex, Gemini, Antigravity, Grok и Cursor. Workers создаются по необходимости и завершаются после выполнения задачи. Для такого режима нужен установленный и авторизованный соответствующий CLI, а также tmux. Это даёт возможность сравнивать архитектуру, проводить code review или делегировать UI-задачи разным моделям, не смешивая их с внутренними Claude Code agents.

Режимы выполнения

OMC предлагает несколько workflow с разной степенью автономности.

• Autopilot — автономное выполнение end-to-end задачи одним lead agent.
• Execute — проведение уже одобренной задачи до проверенного working code.
• Verify — цикл evidence-based проверок, который повторяет quality gates, пока не пройдены build, tests, lint, typecheck и функциональные требования.
• Ralph — персистентный режим: работа продолжается, пока результат не подтверждён verifier.
• Deep interview — Socratic-уточнение требований до начала реализации.
• Ask — запуск внешнего provider CLI и сохранение его ответа как Markdown-артефакта.

Внутри сессии доступны, например, такие команды:

/team 3:executor "implement fullstack todo app"
/execute "refactor auth"
/ralph "refactor auth"
/ralplan "plan this feature"
/deep-interview "vague idea"
/ask codex "review this authentication implementation"

Терминальный advisor запускается через omc ask. Провайдеры включают Claude, Codex, Gemini, Antigravity, Grok и Cursor. Артефакты сохраняются в .omc/artifacts/ask/, поэтому результат можно использовать в следующем шаге workflow.

Для Autopilot предусмотрены именованные stage profiles. Например, профиль plan-build-qa разрешает последовательность ralplan → execution → qa:

/autopilot --workflow plan-build-qa "build a REST API for managing tasks"

Профили задаются в .claude/omc.jsonc проекта или в пользовательском конфигурационном файле. Профили с flock и Linux-специфичным evidence boundary требуют Linux с утилитой flock; это ограничение относится к named profiles, а не к обычному Autopilot.

Агенты и model routing

OMC поставляет специализированных агентов для exploration, analysis, planning, architecture, debugging, implementation, verification, security review, code review, testing, design, documentation, data analysis и критики планов. Агент выбирается по типу задачи, а модель маршрутизируется по сложности: Haiku используется для быстрых операций, Sonnet — для реализации и отладки, Opus — для архитектуры и стратегического review.

Скиллы работают как behavior injections: они не заменяют агента, а добавляют к его работе конкретный режим. Например, team добавляет параллельную координацию, execute — доведение задачи до результата, а ralph — гарантию продолжения до проверки. Такой подход позволяет комбинировать execution skill, enhancement skills и optional guarantee.

Skills и hooks

В plugin входят skills для autopilot, ralph, ralplan, execute, team, verify, deep-interview, research, review, debug, hud, omc-setup и других сценариев. Параллельную работу следует запускать явно через Team, а не полагаться на неявный keyword trigger.

Hooks реагируют на lifecycle Claude Code. Они обнаруживают keywords, добавляют инструкции навыков, отслеживают subagents, сохраняют состояние перед compaction и помогают не остановиться на середине активного persistent workflow. Базовые точки — UserPromptSubmit, SessionStart, PreToolUse, PostToolUse, SubagentStart, PreCompact и Stop.

Пользовательские skills хранятся в .omc/skills/ внутри проекта или ~/.omc/skills/ глобально. Skills уровня проекта имеют приоритет над пользовательскими; OMC также читает workspace skills из .claude/skills/ и compatibility skills из .agents/skills/.

Состояние и артефакты

По умолчанию operational state хранится в .omc/ внутри git-репозитория. Там появляются state-файлы режимов, планы, research, логи, session summaries, handoffs и advisor artifacts. Проект также использует .omc/notepad.md и .omc/project-memory.json, чтобы переживать compaction и переносить знания между сессиями.

.omc/ в целом остаётся локальным рабочим состоянием. Исключение — .omc/skills/**: такие skills можно закоммитить, если команда хочет поделиться ими между worktree. Остальные файлы могут содержать prompts, transcripts, локальные пути и историю работы, поэтому автоматически добавлять их в git не следует.

Для linked worktree state по умолчанию живёт внутри самого worktree и исчезает вместе с ним. Если состояние должно переживать удаление worktree, задаётся OMC_STATE_DIR. Для нескольких независимых репозиториев под общим родителем можно создать marker .omc-workspace; тогда сессии внутри этих репозиториев используют общий state root.

Automation и observability

CLI добавляет операции, пригодные для скриптов и headless-задач:

omc session search "team leader stale"
omc session friction report --since 24h
omc lookout scan --brief "Migrate billing to v2" --json
omc checkpoint create --label "before ralph run"
omc wait --start
omc hud

lookout — advisory pre-flight scan, который проверяет task briefing и workspace на опасные операции, секреты, CI/deploy surfaces и грязный worktree. checkpoint сохраняет рабочее дерево в shadow ref, не изменяя HEAD или текущие файлы. wait умеет возобновлять сессии после rate limit, а HUD показывает состояние оркестрации.

Для внешних workflow доступны notification integrations для Telegram, Discord и Slack, а также OpenClaw gateway для проброса событий Claude Code.

Требования и ограничения

OMC требует Claude Code и Claude Max/Pro subscription либо ANTHROPIC_API_KEY. Для omc team и rate-limit detection нужен tmux. Codex, Gemini, Antigravity, Grok и Cursor — опциональные внешние providers, а не обязательные зависимости.

Проект не поставляет отдельное VS Code extension. Для IDE-сценариев используются интеграции самого Claude Code, а автоматизация строится на CLI, библиотечном Agent SDK surface и детерминированных командах.

Документация

• Полный reference — команды, конфигурация, state, agents и skills.
• Архитектура — hooks, skills, agents, state и verification protocol.
• Миграция — переход на новые версии OMC.
• Native Team Worktree Mode — контракт изолированных worktree для team workers.
• Матрица совместимости моделей и агентов — рекомендации по выбору модели.

Лицензия проекта — MIT.