概要

oh-my-claudecode

"Don't learn Claude Code. Just use OMC."

Claude Code 向けマルチエージェント・オーケストレーション。ゼロ設定・ゼロ学習コスト。
npm パッケージ oh-my-claude-sisyphus、 Marketplace 名は oh-my-claudecode(プラグインリポジトリ)。

v4.15.4 ⭐ 38k stars MIT Node ≥ 20
19
専門エージェント
41
スキル (動作注入)
30–50%
トークンコスト削減
11
実行面(表の行数)
  • ゼロ設定 — インストール後すぐ使えるインテリジェントなデフォルト設定
  • チームファースト — /team N:executor "..." が正規のマルチエージェント実行面(v4.1.7 以降。旧 swarm キーワード/スキルは削除)。パイプラインは team-plan → team-prd → team-exec → team-verify → team-fix
  • 自然言語インターフェース — コマンドを覚えなくてよい。やりたいことを書くだけ
  • 自動並列化 — 複雑なタスクを専門エージェントへ自動分散。Haiku / Sonnet / Opus を目的で使い分け
  • 永続実行 — ralph モードは verifier が完了を確認するまで停止しない
  • スキル学習 — セッションから問題解決パターンを抽出し、次回セッションで自動インジェクション
  • リアルタイム可視化 — HUD ステータスバーでオーケストレーション状況を常時確認
クイックスタート
Step 1 — インストール
Marketplace (推奨)

Claude Code のスラッシュコマンドは1 行ずつ入力する(2 行を同時ペーストすると失敗する)。

/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
続けて
/plugin install oh-my-claudecode
または npm から直接
npm i -g oh-my-claude-sisyphus@latest
deprecated prebuild-install@7.1.3 警告は better-sqlite3 由来で、インストール失敗を意味しない(Issue #2913)。
Step 2 — セットアップ
初期設定
/setup /omc-setup # ターミナルからも可 omc setup
omc --plugin-dir … で実行する場合は omc setup --plugin-dir-mode または事前に OMC_PLUGIN_ROOT を設定し、プラグイン同梱スキルとの二重登録を避ける(詳細は上流の REFERENCE.md Plugin directory flags)。
更新後にキャッシュを消したい場合
/omc-doctor
Step 3 — ビルド
セッション内で起動
/autopilot "build a REST API for managing tasks" # 自然言語ショートカット autopilot: build a REST API for managing tasks
要件が曖昧なら Socratic インタビューから
/deep-interview "アイデア"
tmux 必須: omc team(tmux CLI ワーカー)・レート制限自動再開などは tmux が必要。 macOS → brew install tmux、Windows → winget install psmux(WSL 不要のネイティブ実装)。

Marketplace 利用時は /plugin marketplace update omc のあと /setup を再実行。 npm 経路は npm i -g oh-my-claude-sisyphus@latest。問題時は /omc-doctor。 現行解説のソースは v4.15.4(Team / UltraQA / Antigravity・Grok・Cursor ワーカー、Artifact-only Ultragoal)。

CLI とセッション内スキル

Terminal CLI(シェルで omc …)と In-session skills(Claude Code セッション内の /…)は別ランタイム。同じ名前でも挙動が違うものがある。

機能Terminal CLIIn-session skillメモ
Setup omc setup /setup / /omc-setup どちらも正規エントリ。プラグイン優先なら /setup
Ask providers omc ask codex "…" /ask codex "…" 同じ advisor フロー。claude / codex / gemini / antigravity / grok / cursor
Team omc team 2:codex "…" /team 3:executor "…" omc team は tmux CLI ワーカー。/team はセッション内ネイティブ Team
Autopilot / Ralph / Ultrawork — /autopilot / /ralph / /ultrawork CLI サブコマンドはない(セッション内スキルのみ)
Autoresearch omc autoresearch(hard-deprecated shim) /deep-interview --autoresearch … + 状態保持スキル セットアップは deep-interview、実行は stateful skill
スコープ: VS Code 拡張は同梱しない。Agent SDK の createOmcSession() はライブラリ面。 CI では対話スラッシュ(/autopilot 等)に頼らず、決定的な omc … コマンドを使う。
オーケストレーションモード
モード呼び出し例内容最適用途
Team /team 3:executor "..." 5 ステージパイプライン
team-plan → team-prd → team-exec → team-verify → team-fix
複数 Claude エージェントが共有タスクリストで協調する場合(推奨)
omc team omc team 2:antigravity "..." tmux CLI ワーカー
claude / codex / gemini / antigravity / grok / cursor-agent
外部 CLI タスク。完了後に自動終了してリソース消費なし
ccg /ccg ... 3 モデル統合
/ask codex + /ask antigravity → Claude が統合
バックエンド(Codex) + UI(Antigravity)。Gemini は enterprise / API キーのフォールバック
autopilot /autopilot "..." 単一リードの自律実行 エンド・ツー・エンドの機能実装を最小セレモニーで進める
ultrawork ulw ... / /ultrawork 最大並列実行(非 Team) Team 不要なバースト並列修正・リファクタリング
ralph /ralph "..." 完了まで停止しない verify/fix ループ
ultrawork を自動包含
サイレントな部分完了を許せないタスク
UltraQA /ultraqa ... テスト・ビルド・lint・型チェックが通るまで QA サイクル 品質ゲートを何度も回す必要があるとき
/goal Claude Code /goal ネイティブのクロス・ターン完了条件
OMC のエビデンス台帳ではない
セッション内の測定可能な完了条件を 1 つ置く
Ultragoal omc ultragoal … Artifact-only 台帳
ゴール/チェックポイント/エビデンスを永続化(ループは起動しない)
ハンドオフ・監査、または他ループと衝突するとき
pipeline 明示指定 順次・段階的処理 厳密な順序が必要な多段変換
Ultrapilot (legacy) 非推奨互換モード(autopilot パイプライン別名) 既存ワークフロー・古いドキュメント向け
Goal Workflow Guidance: 1 セッションで primary loop authority は 1 つ。 /goal(ネイティブ完了条件)・Ralph(単一エージェント検証完了)・Team(並列ステージ)・UltraQA(品質ゲート反復)を混在させない。 Artifact-only Ultragoal は台帳が欲しいときの安全なフォールバック。 ralplan は Orchestration Modes 表外の計画コンセンサス・ショートカット。
コマンド起動するもの用途例
omc team N:codex "…"N 個の Codex pane実装・レビュー
omc team N:antigravity "…"N 個の Antigravity (agy) paneUI/UX・大コンテキスト
omc team N:grok "…"N 個の Grok pane代替モデルでの並列作業
omc team N:cursor "…"N 個の Cursor agent paneexecutor 風の実装タスク
/ccg …/ask codex + /ask antigravity三モデル助言の統合

Gemini CLI は Google の Antigravity CLI(agy)へ移行中。従来の gemini 指定は引き続き使えるが、新規は antigravity を優先。 Autopilot の executor に Cursor を寄せる設定例は .claude/omc.jsonc の execution: "team" と team.agentTypes: ["cursor"]。

アーキテクチャ

OMC は Hooks・Skills・Agents・State の 4 システムが連鎖して動作する。 フックがライフサイクルイベントを検出し、スキルが動作を注入し、エージェントがタスクを実行し、ステートが進捗を永続化する。

システム全体フロー
%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#dbeafe', 'primaryTextColor': '#1e3a5f', 'primaryBorderColor': '#93c5fd', 'lineColor': '#3b82f6', 'edgeLabelBackground': '#f0f7ff', 'fontSize': '15px'}}}%%
flowchart LR
    A["User\nInput"] --> B["Hooks\n(event detection)"]
    B --> C["Skills\n(behavior injection)"]
    C --> D["Agents\n(task execution)"]
    D --> E["State\n(.omc/)"]
    E -. "notepad / memory" .-> C

Claude Code の 11 ライフサイクルイベントに、21 hooks を登録。<system-reminder> タグで追加コンテキストをインジェクション。 下表は代表例。

フック名イベント役割
keyword-detectorUserPromptSubmitマジックキーワード検出 → [MAGIC KEYWORD: ...] でスキルを有効化
persistent-modeStopralph / ultrawork / ultraqa がアクティブな間は停止をブロック。"The boulder never stops"
pre-compactPreCompactコンパクション前に重要情報を notepad.md へ保存し、コンテキストリセット後も継続
subagent-trackerSubagentStart/Stop実行中エージェントを追跡し、停止時に出力を検証
context-guard-stopStopコンテキスト使用量を監視し、上限接近を警告
code-simplifierStop(任意)停止時に変更ファイルを自動簡素化。デフォルト無効
スキル合成レイヤー(上から下へ重ねる)
%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#fef9c3', 'primaryTextColor': '#78350f', 'primaryBorderColor': '#fbbf24', 'lineColor': '#d97706', 'fontSize': '14px'}}}%%
flowchart TD
    G["Guarantee Layer\nralph — 完了まで停止しない"] --> E["Enhancement Layer\nultrawork, ultraqa, deep-interview …"]
    E --> X["Execution Layer\nteam, autopilot, plan"]
例: ralph: refactor API
→ ralph(保証)が ultrawork(並列)を包含し、実行層スキルと合成
式: [Execution Skill] + [0-N Enhancements] + [Optional Guarantee]
/team コマンド実行フロー
%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#dbeafe', 'primaryTextColor': '#1e3a5f', 'primaryBorderColor': '#93c5fd', 'lineColor': '#3b82f6', 'fontSize': '14px'}}}%%
flowchart LR
    P["team-plan"] --> R["team-prd"] --> EX["team-exec"] --> V["team-verify"] --> F["team-fix"]
    F -. "issues remain" .-> EX

ネイティブ Team の worktree 分離はオプトイン。契約・状態ルート・dirty worktree 保全は TEAM-WORKTREE-MODE.md を参照。

Claude Code native teams を有効化するには ~/.claude/settings.json に "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" を設定。 無効の場合は OMC が警告し非チーム実行にフォールバック。

エージェント一覧(19 専門エージェント)

探索から検証まで開発ライフサイクル全体をカバーする 8 エージェント。

エージェントモデル役割
explorehaikuコードベース探索・ファイル/シンボルマッピング
analystopus要件分析・隠れた制約の発見
planneropusタスクシーケンス作成・実行計画立案
architectopusシステム設計・インターフェース定義・トレードオフ分析
debuggersonnet根本原因分析・ビルドエラー解消
executorsonnetコード実装・リファクタリング
verifiersonnet完了検証・テスト十分性の確認
tracersonnetエビデンス駆動の因果追跡・競合仮説分析
レーンエージェントモデル役割
Review security-revieweropus脆弱性・トラストバウンダリ・認証/認可レビュー
code-revieweropus包括的コードレビュー・API 契約・後方互換性確認
Domain test-engineersonnetテスト戦略・カバレッジ・フレイキーテスト対策
designersonnetUI/UX アーキテクチャ・インタラクションデザイン
writerhaikuドキュメント・マイグレーションノート作成
document-specialistsonnet公式ドキュメント・API 参照・外部文献の調査と引用(コード実装探索は explore)
qa-testersonnettmux 経由での CLI/サービスランタイム検証
scientistsonnetデータ分析・統計調査
git-mastersonnetGit 操作・コミット・リベース・履歴管理
code-simplifieropusコードの明確化・単純化・保守性向上
Coord criticopus計画・設計のギャップ分析(多角的レビュー)。Gap がなくなるまでループ

モデルルーティング — 3 ティア

ティアモデル特性割り当てエージェント
LOWhaiku高速・低コストexplore, writer
MEDIUMsonnetバランスexecutor, debugger, test-engineer, designer, document-specialist, …
HIGHopus最高品質推論architect, planner, critic, code-reviewer, security-reviewer, analyst, code-simplifier
典型ワークフロー: explore → analyst → planner → critic → executor → verifier
モデル×エージェントのプリセットは Model × Agent Compatibility Matrix を参照。
スキル & マジックキーワード

ビルトインは 41 スキル(skills/)。セッションで獲得した知識はポータブルなスキルファイルに抽出し、関連時に自動インジェクション。 実行時は .omc/skills/・~/.omc/skills/ に加え、.claude/skills/ と .agents/skills/ も読む。

# .omc/skills/fix-proxy-crash.md
---
name: Fix Proxy Crash
description: aiohttp proxy crashes on ClientDisconnectedError
triggers: ["proxy", "aiohttp", "disconnected"]
source: extracted
---
Wrap handler at server.py:42 in try/except ClientDisconnectedError...
.omc/skills/

コミット対象の例外。.omc/ 他はローカル運用状態として gitignore

~/.omc/skills/

全プロジェクト共通。優先度 低(フォールバック)

管理コマンド: /skill list | add | remove | edit | search
自動学習: /learner で厳格な品質ゲート付きパターン抽出
Skillify: /skillify で再利用パターンを品質ゲート付き抽出
代表スキル: team, ultraqa, ultragoal, ai-slop-cleaner, merge-readiness, wiki, sciomc, visual-verdict

プロンプトにキーワードを含めるだけで対応スキルが自動起動。 Team は bare keyword ではなく 明示的に /team(またはシェルの omc team)。 autopilot・ralph・ccg はフックにハードコードされており config では変更不可。

キーワード効果使用例
/teamTeam オーケストレーション(正規 API)/team 3:executor "fix TypeScript errors"
omc teamtmux CLI ワーカーomc team 2:codex "security review"
ccgcodex + antigravity 助言の統合/ccg review this PR
autopilot完全自律実行/autopilot "build a todo app"
ralph永続モード(完了まで停止しない)/ralph "refactor auth"
ulw最大並列実行(ultrawork)ulw fix all errors
ralplan反復的計画コンセンサスralplan this feature
deepsearchコードベース探索ルーティングdeepsearch for auth middleware
deep-interviewSocratic 式要件明確化/deep-interview "vague idea"
ultrathink深い推論モードultrathink about this architecture
ai-slop / deslopAI スロップ掃除(ai-slop-cleaner)deslop this PR
tddテスト駆動開発ワークフロー(HOOKS 拡張)tdd: implement payment flow
cancelomc / stopomcアクティブモードを即時停止stopomc
状態管理 & ユーティリティ
.omc/
├── state/
│   ├── autopilot-state.json   # autopilot フェーズ進捗
│   ├── ralph-state.json       # ralph ループ状態
│   └── sessions/{sessionId}/  # セッション別ステート
├── notepad.md                 # コンパクション耐性メモパッド
├── project-memory.json        # プロジェクト知識ストア (セッション横断)
├── ultragoal/                 # Artifact Ultragoal 台帳
├── skills/                    # プロジェクト共有スキル(gitignore 例外)
├── plans/                     # 実行計画ファイル
├── notepads/{plan-name}/
│   ├── learnings.md
│   ├── decisions.md
│   ├── issues.md
│   └── problems.md
├── autopilot/spec.md
├── artifacts/ask/             # omc ask の出力 Markdown
└── logs/
コンパクション耐性: PreCompact フックが重要情報を notepad.md に保存。 コンパクション後も再インジェクションされ文脈が継続。 <remember priority>... タグで永続メモを作成可能。

ワークツリー削除後も状態を保持するには export OMC_STATE_DIR="$HOME/.claude/omc" を設定。 マルチリポジトリ作業ではルートに .omc-workspace マーカーを置き、各リポジトリの状態を分離する。

コマンド説明
omc ultragoal create-goals …ブリーフからゴール台帳を生成し .omc/ultragoal/ に保存(ループは起動しない)
omc ultragoal complete-goals次ストーリー用ハンドオフを出力(Claude Code /goal 自体は操作しない)
/ask <provider> "…"セッション内アドバイザー。claude / codex / gemini / antigravity / grok / cursor
omc ask …同上の CLI。結果を .omc/artifacts/ask/ に Markdown 保存
omc autoresearchhard-deprecated shim。調査は /deep-interview --autoresearch … 側へ移行
omc wait --startレート制限リセット時の自動再開デーモン(tmux 必須)
omc hudHUD ライブレンダリング
omc team status|shutdown …実行中チームの状態確認・停止
omc session search / omc teleportセッション検索・復帰(CI 向け決定的コマンド)
/omc-doctorインストール診断・プラグインキャッシュクリア
/learner / /deepinitスキル抽出 / 階層的 AGENTS.md 生成

セッション完了サマリーを Telegram・Discord・Slack へ自動送信。 omc config-stop-callback telegram --enable --token <tok> --chat <id> --tag-list "@alice" で設定。 タグ付きプロフィールの増分更新は README の Notification Tags を参照。

OpenClaw Gateway: Claude Code セッションイベント(session-start, stop, keyword-detector など 6 種)を 外部エージェントへフォワード。/oh-my-claudecode:configure-notifications でウィザード起動。