oh-my-claudecode
"Don't learn Claude Code. Just use OMC."
Claude Code 向けマルチエージェント・オーケストレーション。ゼロ設定・ゼロ学習コスト。
npm パッケージ oh-my-claude-sisyphus、
Marketplace 名は oh-my-claudecode(プラグインリポジトリ)。
- ゼロ設定 — インストール後すぐ使えるインテリジェントなデフォルト設定
- チームファースト —
/team N:executor "..."が正規のマルチエージェント実行面(v4.1.7 以降。旧swarmキーワード/スキルは削除)。パイプラインはteam-plan → team-prd → team-exec → team-verify → team-fix - 自然言語インターフェース — コマンドを覚えなくてよい。やりたいことを書くだけ
- 自動並列化 — 複雑なタスクを専門エージェントへ自動分散。Haiku / Sonnet / Opus を目的で使い分け
- 永続実行 — ralph モードは
verifierが完了を確認するまで停止しない - スキル学習 — セッションから問題解決パターンを抽出し、次回セッションで自動インジェクション
- リアルタイム可視化 — HUD ステータスバーでオーケストレーション状況を常時確認
Claude Code のスラッシュコマンドは1 行ずつ入力する(2 行を同時ペーストすると失敗する)。
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
/plugin install oh-my-claudecode
npm i -g oh-my-claude-sisyphus@latest
deprecated prebuild-install@7.1.3 警告は better-sqlite3 由来で、インストール失敗を意味しない(Issue #2913)。/setup
/omc-setup
# ターミナルからも可
omc setup
omc --plugin-dir … で実行する場合は omc setup --plugin-dir-mode または事前に OMC_PLUGIN_ROOT を設定し、プラグイン同梱スキルとの二重登録を避ける(詳細は上流の REFERENCE.md Plugin directory flags)。/omc-doctor
/autopilot "build a REST API for managing tasks"
# 自然言語ショートカット
autopilot: build a REST API for managing tasks
/deep-interview "アイデア"
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)。
Terminal CLI(シェルで omc …)と In-session skills(Claude Code セッション内の /…)は別ランタイム。同じ名前でも挙動が違うものがある。
| 機能 | Terminal CLI | In-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 |
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(ネイティブ完了条件)・Ralph(単一エージェント検証完了)・Team(並列ステージ)・UltraQA(品質ゲート反復)を混在させない。
Artifact-only Ultragoal は台帳が欲しいときの安全なフォールバック。
ralplan は Orchestration Modes 表外の計画コンセンサス・ショートカット。
| コマンド | 起動するもの | 用途例 |
|---|---|---|
omc team N:codex "…" | N 個の Codex pane | 実装・レビュー |
omc team N:antigravity "…" | N 個の Antigravity (agy) pane | UI/UX・大コンテキスト |
omc team N:grok "…" | N 個の Grok pane | 代替モデルでの並列作業 |
omc team N:cursor "…" | N 個の Cursor agent pane | executor 風の実装タスク |
/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-detector | UserPromptSubmit | マジックキーワード検出 → [MAGIC KEYWORD: ...] でスキルを有効化 |
persistent-mode | Stop | ralph / ultrawork / ultraqa がアクティブな間は停止をブロック。"The boulder never stops" |
pre-compact | PreCompact | コンパクション前に重要情報を notepad.md へ保存し、コンテキストリセット後も継続 |
subagent-tracker | SubagentStart/Stop | 実行中エージェントを追跡し、停止時に出力を検証 |
context-guard-stop | Stop | コンテキスト使用量を監視し、上限接近を警告 |
code-simplifier | Stop | (任意)停止時に変更ファイルを自動簡素化。デフォルト無効 |
%%{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]
%%{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 が警告し非チーム実行にフォールバック。
探索から検証まで開発ライフサイクル全体をカバーする 8 エージェント。
| エージェント | モデル | 役割 |
|---|---|---|
explore | haiku | コードベース探索・ファイル/シンボルマッピング |
analyst | opus | 要件分析・隠れた制約の発見 |
planner | opus | タスクシーケンス作成・実行計画立案 |
architect | opus | システム設計・インターフェース定義・トレードオフ分析 |
debugger | sonnet | 根本原因分析・ビルドエラー解消 |
executor | sonnet | コード実装・リファクタリング |
verifier | sonnet | 完了検証・テスト十分性の確認 |
tracer | sonnet | エビデンス駆動の因果追跡・競合仮説分析 |
| レーン | エージェント | モデル | 役割 |
|---|---|---|---|
| Review | security-reviewer | opus | 脆弱性・トラストバウンダリ・認証/認可レビュー |
code-reviewer | opus | 包括的コードレビュー・API 契約・後方互換性確認 | |
| Domain | test-engineer | sonnet | テスト戦略・カバレッジ・フレイキーテスト対策 |
designer | sonnet | UI/UX アーキテクチャ・インタラクションデザイン | |
writer | haiku | ドキュメント・マイグレーションノート作成 | |
document-specialist | sonnet | 公式ドキュメント・API 参照・外部文献の調査と引用(コード実装探索は explore) | |
qa-tester | sonnet | tmux 経由での CLI/サービスランタイム検証 | |
scientist | sonnet | データ分析・統計調査 | |
git-master | sonnet | Git 操作・コミット・リベース・履歴管理 | |
code-simplifier | opus | コードの明確化・単純化・保守性向上 | |
| Coord | critic | opus | 計画・設計のギャップ分析(多角的レビュー)。Gap がなくなるまでループ |
モデルルーティング — 3 ティア
| ティア | モデル | 特性 | 割り当てエージェント |
|---|---|---|---|
| LOW | haiku | 高速・低コスト | explore, writer |
| MEDIUM | sonnet | バランス | executor, debugger, test-engineer, designer, document-specialist, … |
| HIGH | opus | 最高品質推論 | 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 では変更不可。
| キーワード | 効果 | 使用例 |
|---|---|---|
| /team | Team オーケストレーション(正規 API) | /team 3:executor "fix TypeScript errors" |
| omc team | tmux CLI ワーカー | omc team 2:codex "security review" |
| ccg | codex + 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-interview | Socratic 式要件明確化 | /deep-interview "vague idea" |
| ultrathink | 深い推論モード | ultrathink about this architecture |
| ai-slop / deslop | AI スロップ掃除(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 autoresearch | hard-deprecated shim。調査は /deep-interview --autoresearch … 側へ移行 |
omc wait --start | レート制限リセット時の自動再開デーモン(tmux 必須) |
omc hud | HUD ライブレンダリング |
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 でウィザード起動。
- GitHub リポジトリ — ソース・Issue・Marketplace プラグイン URL
- 公式サイト(ドキュメント) — Quick Start 以外の詳細
- CLI Reference · Workflows · Execution Modes
- Migration Guide · REFERENCE.md · HOOKS.md
- npm: oh-my-claude-sisyphus
- Discord · Sponsor
- Codex 向け姉妹プロジェクト: oh-my-codex