概要

oh-my-claudecode

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

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

v4.10.1 ⭐ 11k stars MIT Node ≥ 20
19
専門エージェント
31
スキル (動作注入)
30–50%
トークンコスト削減
8
実行モード
  • ゼロ設定 — インストール後すぐ使えるインテリジェントなデフォルト設定
  • チームファースト/team N:executor "..." が正規のマルチエージェント実行面。plan → prd → exec → verify → fix の 5 ステージパイプライン
  • 自然言語インターフェース — コマンドを覚えなくてよい。やりたいことを書くだけ
  • 自動並列化 — 複雑なタスクを専門エージェントへ自動分散。Haiku / Sonnet / Opus を目的で使い分け
  • 永続実行 — ralph モードは verifier が完了を確認するまで絶対に停止しない
  • スキル学習 — セッションから問題解決パターンを抽出し、次回セッションで自動インジェクション
  • リアルタイム可視化 — HUD ステータスバーでオーケストレーション状況を常時確認
クイックスタート
Step 1 — インストール
Marketplace (推奨)
/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
Step 2 — セットアップ
初期設定ウィザード
/setup /omc-setup
更新後にキャッシュを消したい場合
/omc-doctor
Step 3 — ビルド
そのまま話しかける
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 不要のネイティブ実装)。
オーケストレーションモード
モード呼び出し例内容最適用途
Team /team 3:executor "..." 5 ステージパイプライン
plan→prd→exec→verify→fix
複数 Claude エージェントが共有タスクリストで協調する場合(推奨
omc team omc team 2:codex "..." tmux CLI ワーカー
claude/codex/gemini を実プロセスで起動
Codex・Gemini CLI タスク。完了後に自動終了してリソース消費なし
autopilot autopilot: ... 5 フェーズ自律パイプライン
expand→plan→exec→qa→validate
アイデアから動くコードまで自動生成。エンド・ツー・エンド
ralph ralph: ... 完了まで絶対停止しないループ
verifier が確認するまで継続
サイレントな部分完了を許せないタスク。ultrawork を自動包含
ultrawork ulw ... 最大並列実行(非 Team) Team 不要なバースト並列修正・リファクタリング
ccg /ccg ... 3 モデル統合
/ask codex + /ask gemini → Claude が統合
バックエンド(Codex) + UI(Gemini) を同時レビューして Claude が統合
ralplan ralplan ... Planner・Architect・Critic の合意ループ 計画の反復的コンセンサス形成
pipeline 明示指定 順次・段階的処理 厳密な順序が必要な多段変換
アーキテクチャ

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 ライフサイクルイベントにフックを登録。<system-reminder> タグで追加コンテキストをインジェクション。

フック名イベント役割
keyword-detectorUserPromptSubmitマジックキーワード検出 → [MAGIC KEYWORD: ...] でスキルを有効化
persistent-modeStopralph/ultrawork がアクティブな間は停止をブロック。"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, git-master, frontend-ui-ux …"]
    E --> X["Execution Layer\ndefault, orchestrate, planner"]
例: ultrawork: refactor API with proper commits
ultrawork + default + git-master の 3 スキルが同時活性化
式: [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

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-reviewersonnet脆弱性・トラストバウンダリ・認証/認可レビュー
code-revieweropus包括的コードレビュー・API 契約・後方互換性確認
Domain test-engineersonnetテスト戦略・カバレッジ・フレイキーテスト対策
designersonnetUI/UX アーキテクチャ・インタラクションデザイン
writerhaikuドキュメント・マイグレーションノート作成
qa-testersonnettmux 経由での CLI/サービスランタイム検証
scientistsonnetデータ分析・統計調査
git-mastersonnetGit 操作・コミット・リベース・履歴管理
code-simplifieropusコードの明確化・単純化・保守性向上
Coord criticopus計画・設計のギャップ分析(多角的レビュー)。Gap がなくなるまでループ

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

ティアモデル特性割り当てエージェント
LOWhaiku高速・低コストexplore, writer
MEDIUMsonnetバランスexecutor, debugger, test-engineer, designer …
HIGHopus最高品質推論architect, planner, critic, code-reviewer, analyst
典型ワークフロー: exploreanalystplannercriticexecutorverifier
スキル & マジックキーワード

セッションで獲得したデバッグ知識をポータブルな YAML スキルファイルに抽出。 関連するときにコンテキストへ自動インジェクションされ、手動リコールは不要。

# .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/skills/

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

管理コマンド: /skill list | add | remove | edit | search
自動学習: /learner で厳格な品質ゲート付きパターン抽出

プロンプトにキーワードを含めるだけで対応スキルが自動起動。 autopilotralphccg はフックにハードコードされており config では変更不可。

キーワード効果使用例
teamTeam オーケストレーション(正規 API)/team 3:executor "fix TypeScript errors"
omc teamtmux CLI ワーカーomc team 2:codex "security review"
ccg3 モデル統合アドバイス/ccg review this PR
autopilot完全自律実行パイプラインautopilot: build a todo app
ralph永続モード(完了まで停止しない)ralph: refactor auth
ulw最大並列実行(ultrawork)ulw fix all errors
ralplan反復的計画コンセンサスralplan this feature
deep-interviewSocratic 式要件明確化/deep-interview "vague idea"
ultrathink深い推論モードultrathink about this architecture
tddテスト駆動開発ワークフローtdd: implement payment flow
stopomcアクティブモードを即時停止stopomc
状態管理 & ユーティリティ
.omc/
├── state/
│   ├── autopilot-state.json   # autopilot フェーズ進捗
│   ├── ralph-state.json       # ralph ループ状態
│   └── sessions/{sessionId}/  # セッション別ステート
├── notepad.md                 # コンパクション耐性メモパッド
├── project-memory.json        # プロジェクト知識ストア (セッション横断)
├── plans/                     # 実行計画ファイル
├── notepads/{plan-name}/
│   ├── learnings.md           # 成功パターン・規約
│   ├── decisions.md           # 設計判断と根拠
│   ├── issues.md              # 問題・ブロッカー
│   └── problems.md            # 技術的負債・注意点
├── autopilot/spec.md          # autopilot 仕様書
├── artifacts/ask/             # omc ask の出力 Markdown
└── logs/                      # 実行ログ
コンパクション耐性: PreCompact フックが重要情報を notepad.md に保存。 コンパクション後も再インジェクションされ文脈が継続。 <remember priority>... タグで永続メモを作成可能。

ワークツリー削除後も状態を保持するには export OMC_STATE_DIR="$HOME/.claude/omc" を設定。 プロジェクト識別子は Git リモート URL のハッシュなので同リポジトリで共有される。

コマンド説明
omc ask claude "..."ローカル Claude CLI を呼び出し結果を .omc/artifacts/ask/ に Markdown 保存
omc ask codex|gemini "..."Codex / Gemini CLI へのプロキシ + 結果保存
omc wait --startレート制限リセット時の自動再開デーモン(tmux 必須)
omc hudHUD ライブレンダリング。オーケストレーション状況をステータスバーに表示
omc team status <name>実行中チームタスクの状態確認
omc team shutdown <name>指定チームを停止
/omc-doctorインストール診断・プラグインキャッシュクリア
/learnerセッションから再利用可能スキルを品質ゲート付きで抽出
/deepinitプロジェクトの階層的 AGENTS.md を自動生成

セッション完了サマリーを Telegram・Discord・Slack へ自動送信。 omc config-stop-callback telegram --enable --token <tok> --chat <id> --tag-list "@alice" で設定。

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