oh-my-githubcopilot 1.4.1 → 1.8.0-alpha.021bf87

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (123) hide show
  1. package/.claude-plugin/plugin.json +36 -6
  2. package/.mcp.json +17 -0
  3. package/AGENTS.md +78 -9
  4. package/CHANGELOG.md +216 -1
  5. package/README.de.md +112 -26
  6. package/README.es.md +115 -29
  7. package/README.fr.md +114 -28
  8. package/README.it.md +114 -28
  9. package/README.ja.md +112 -26
  10. package/README.ko.md +112 -26
  11. package/README.md +96 -95
  12. package/README.pt.md +116 -30
  13. package/README.ru.md +116 -30
  14. package/README.tr.md +115 -29
  15. package/README.vi.md +116 -30
  16. package/README.zh.md +112 -26
  17. package/agents/analyst.agent.md +27 -0
  18. package/agents/architect.agent.md +24 -0
  19. package/agents/code-reviewer.agent.md +24 -0
  20. package/agents/critic.agent.md +24 -0
  21. package/agents/debugger.agent.md +24 -0
  22. package/agents/designer.agent.md +24 -0
  23. package/agents/document-specialist.agent.md +24 -0
  24. package/agents/executor.agent.md +27 -0
  25. package/agents/explorer.agent.md +23 -0
  26. package/agents/git-master.agent.md +24 -0
  27. package/agents/orchestrator.agent.md +26 -0
  28. package/agents/planner.agent.md +24 -0
  29. package/agents/qa-tester.agent.md +24 -0
  30. package/agents/researcher.agent.md +18 -0
  31. package/agents/reviewer.agent.md +23 -0
  32. package/agents/scientist.agent.md +20 -0
  33. package/agents/security-reviewer.agent.md +20 -0
  34. package/agents/simplifier.agent.md +20 -0
  35. package/agents/test-engineer.agent.md +20 -0
  36. package/agents/tester.agent.md +20 -0
  37. package/agents/tracer.agent.md +24 -0
  38. package/agents/verifier.agent.md +19 -0
  39. package/agents/writer.agent.md +24 -0
  40. package/bin/omp-statusline.mjs +179 -0
  41. package/bin/omp-statusline.mjs.map +7 -0
  42. package/bin/omp-statusline.sh +21 -0
  43. package/bin/omp.mjs +709 -16
  44. package/bin/omp.mjs.map +4 -4
  45. package/dist/hooks/hud-emitter.mjs +268 -82
  46. package/dist/hooks/hud-emitter.mjs.map +4 -4
  47. package/dist/hooks/keyword-detector.mjs +100 -23
  48. package/dist/hooks/keyword-detector.mjs.map +2 -2
  49. package/dist/hooks/model-router.mjs +1 -1
  50. package/dist/hooks/model-router.mjs.map +1 -1
  51. package/dist/hooks/stop-continuation.mjs +1 -1
  52. package/dist/hooks/stop-continuation.mjs.map +1 -1
  53. package/dist/hooks/token-tracker.mjs +2 -1
  54. package/dist/hooks/token-tracker.mjs.map +2 -2
  55. package/dist/mcp/server.mjs +85 -53
  56. package/dist/mcp/server.mjs.map +4 -4
  57. package/dist/skills/setup.mjs +39 -27
  58. package/dist/skills/setup.mjs.map +4 -4
  59. package/hooks/hooks.json +39 -45
  60. package/package.json +9 -4
  61. package/plugin.json +71 -0
  62. package/skills/ai-slop-cleaner/SKILL.md +137 -0
  63. package/skills/autopilot/SKILL.md +6 -0
  64. package/skills/configure-notifications/SKILL.md +6 -0
  65. package/skills/deep-interview/SKILL.md +6 -0
  66. package/skills/doctor/SKILL.md +188 -0
  67. package/skills/ecomode/SKILL.md +6 -0
  68. package/skills/graph-context/SKILL.md +119 -0
  69. package/skills/graph-provider/SKILL.md +6 -0
  70. package/skills/graphify/SKILL.md +6 -0
  71. package/skills/graphwiki/SKILL.md +6 -0
  72. package/skills/hud/SKILL.md +6 -0
  73. package/skills/improve-codebase-architecture/SKILL.md +214 -0
  74. package/skills/interactive-menu/SKILL.md +102 -0
  75. package/skills/interview/SKILL.md +203 -0
  76. package/skills/learner/SKILL.md +6 -0
  77. package/skills/mcp-setup/SKILL.md +6 -0
  78. package/skills/note/SKILL.md +6 -0
  79. package/skills/notifications/SKILL.md +190 -0
  80. package/skills/omp-doctor/SKILL.md +146 -0
  81. package/skills/omp-plan/SKILL.md +219 -2
  82. package/skills/omp-reference/SKILL.md +174 -0
  83. package/skills/omp-setup/SKILL.md +15 -1
  84. package/skills/pipeline/SKILL.md +6 -0
  85. package/skills/psm/SKILL.md +6 -0
  86. package/skills/ralph/SKILL.md +6 -0
  87. package/skills/ralplan/SKILL.md +148 -0
  88. package/skills/release/SKILL.md +6 -0
  89. package/skills/research/SKILL.md +149 -0
  90. package/skills/session/SKILL.md +220 -0
  91. package/skills/setup/SKILL.md +6 -0
  92. package/skills/skillify/SKILL.md +66 -0
  93. package/skills/spending/SKILL.md +6 -0
  94. package/skills/swarm/SKILL.md +6 -0
  95. package/skills/swe-bench/SKILL.md +6 -0
  96. package/skills/tdd/SKILL.md +246 -0
  97. package/skills/team/SKILL.md +6 -0
  98. package/skills/trace/SKILL.md +6 -0
  99. package/skills/ultrawork/SKILL.md +6 -0
  100. package/skills/wiki/SKILL.md +6 -0
  101. package/src/agents/analyst.md +0 -103
  102. package/src/agents/architect.md +0 -169
  103. package/src/agents/code-reviewer.md +0 -135
  104. package/src/agents/critic.md +0 -196
  105. package/src/agents/debugger.md +0 -132
  106. package/src/agents/designer.md +0 -103
  107. package/src/agents/document-specialist.md +0 -111
  108. package/src/agents/executor.md +0 -120
  109. package/src/agents/explorer.md +0 -98
  110. package/src/agents/git-master.md +0 -92
  111. package/src/agents/orchestrator.md +0 -125
  112. package/src/agents/planner.md +0 -106
  113. package/src/agents/qa-tester.md +0 -129
  114. package/src/agents/researcher.md +0 -102
  115. package/src/agents/reviewer.md +0 -100
  116. package/src/agents/scientist.md +0 -150
  117. package/src/agents/security-reviewer.md +0 -132
  118. package/src/agents/simplifier.md +0 -109
  119. package/src/agents/test-engineer.md +0 -124
  120. package/src/agents/tester.md +0 -102
  121. package/src/agents/tracer.md +0 -160
  122. package/src/agents/verifier.md +0 -100
  123. package/src/agents/writer.md +0 -96
package/README.ja.md CHANGED
@@ -1,53 +1,139 @@
1
- [English](README.md) | [Deutsch](README.de.md) | [Español](README.es.md) | [Français](README.fr.md) | [Italiano](README.it.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Português](README.pt.md) | [Русский](README.ru.md) | [Türkçe](README.tr.md) | [Tiếng Việt](README.vi.md) | [中文](README.zh.md)
1
+ # oh-my-githubcopilot (omp)
2
2
 
3
- # oh-my-githubcopilot
4
- <p align="center">
5
- <img src="assets/omp-banner.png" alt="Oh My Copilot" width="100%"/>
6
- </p>
3
+ > **Sister projects:** [oh-my-claudecode (OMC)](https://github.com/Yeachan-Heo/oh-my-claudecode) | [oh-my-codex (OMX)](https://github.com/Yeachan-Heo/oh-my-codex) | [oh-my-githubcopilot (OMP)](https://github.com/r3dlex/oh-my-githubcopilot) | [oh-my-antigravity (OMG)](https://github.com/r3dlex/oh-my-antigravity) | [oh-my-auggie (OMA)](https://github.com/r3dlex/oh-my-auggie)
7
4
 
8
- [![npm version](https://img.shields.io/npm/v/oh-my-githubcopilot?color=cb3837)](https://www.npmjs.com/package/oh-my-githubcopilot)
9
- [![npm downloads](https://img.shields.io/npm/dm/oh-my-githubcopilot?color=blue)](https://www.npmjs.com/package/oh-my-githubcopilot)
10
- [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
5
+ **GitHub Copilot CLI のためのマルチエージェント・オーケストレーション。学習コストはゼロ。**
11
6
 
12
- **Oh-My-Copilot (OMP)** は、GitHub Copilot にモダンなワークフローオーケストレーションとエージェント型 AI 機能を追加するプラグインおよび拡張機能です。
7
+ _GitHub Copilot CLI を覚える必要はありません。omp を使うだけです。_
8
+
9
+ [Get Started](#quick-start) • [CLI Reference](#cli-reference) • [Workflows](#workflows) • [Discord](https://discord.gg/PUwSMR9XNk)
13
10
 
14
- <p align="center">
15
- <img src="assets/buddy-swarm.png" alt="OMP swarm mode" width="600"/>
16
- </p>
17
11
  ---
18
12
 
13
+ ## なぜ omp?
14
+
15
+ ソフトウェアチームは実装、アーキテクチャ、セキュリティレビュー、テスト、DevOps を同時に扱います。omp は専門エージェントを並列にオーケストレーションし、各領域に専門的な注意を届けます。
16
+
17
+ GitHub Copilot は多くの開発者が助けを求める場所です。omp はその場を協調するエンジニアリングチームへ変えます。Copilot 向けのエージェント、スキル、フック、MCP 設定、HUD 状態を予測可能なワークフローにまとめ、プロンプトから検証済みの成果まで進めます。
18
+
19
+ ---
20
+
21
+ <a id="quick-start"></a>
19
22
  ## クイックスタート
20
23
 
21
24
  ```bash
22
- # インストール
23
25
  npm install -g oh-my-githubcopilot
26
+ omp setup --scope project
27
+ omp
28
+ ```
24
29
 
25
- # 設定
26
- omp setup
30
+ セットアップ後、`/` コマンドを表示するために CLI を再起動してください。
31
+
32
+ ```bash
33
+ omp doctor # check prerequisites
34
+ omp team run --task "..." --workers 2 # parallel work
35
+ omp hud --watch # live status
27
36
  ```
28
- <p align="center">
29
- <img src="assets/buddy-playful.png" alt="OMP in action" width="600"/>
30
- </p>
31
37
 
32
38
  ---
33
39
 
34
40
  ## 機能
35
41
 
36
- - **マルチエージェントオーケストレーション** - 様々なタスクに対応する18の specialized エージェント
37
- - **MCP サーバー統合** - 外部サービスやツールへの接続
38
- - **HUD ディスプレイ** - リアルタイムの状態とコンテキスト追跡
39
- - **Plugin State Manager** - セッション間で信頼性の高い状態管理
40
- - **30+ スキル** - 拡張機能のための遅延ロード
42
+ | Feature | Description |
43
+ |---------|-------------|
44
+ | **Specialized Agents** | 23+ agents (analyst, architect, executor, debugger, critic, verifier, test-engineer, writer, and more) |
45
+ | **Parallel Team Mode** | tmux-based multi-worker orchestration with shared task state |
46
+ | **Workflow Skills** | 39 skills built in — plan, deep-interview, ralph, autopilot, ultrawork, code-review, and more |
47
+ | **Persistent Hooks** | Automatic tool tracking, project memory, session management |
48
+ | **Real-time HUD** | Live status overlay showing agents, costs, and progress |
49
+ | **CI/CD Ready** | Verification gates, test integration, release workflows |
50
+ | **Multilingual** | README in 12 languages |
51
+
52
+ ---
53
+
54
+ <a id="cli-reference"></a>
55
+ ## CLI リファレンス
56
+
57
+ | Command | Description |
58
+ |---------|-------------|
59
+ | `omp` | Launch interactive session |
60
+ | `omp setup` | Configure GitHub Copilot CLI integration |
61
+ | `omp doctor` | Check prerequisites and fix issues |
62
+ | `omp team run` | Start parallel team execution |
63
+ | `omp team status` | Check team progress |
64
+ | `omp hud --watch` | Show live status overlay |
65
+ | `omp trace` | Show execution trace |
66
+
67
+ See the [full documentation](https://github.com/r3dlex/oh-my-githubcopilot#readme) for all commands.
68
+
69
+ ---
70
+
71
+ <a id="workflows"></a>
72
+ ## ワークフロー
73
+
74
+ omp ships execution-mode and planning-mode workflows as built-in skills.
75
+
76
+ ### Execution Modes
77
+
78
+ | Skill | Purpose |
79
+ |-------|---------|
80
+ | `$autopilot` | Idea → working code end-to-end |
81
+ | `$team` | N coordinated agents on a shared task |
82
+ | `$ralph` | Persistent completion loop until verified |
83
+ | `$ultrawork` | Maximum parallel throughput execution |
84
+ | `$ultraqa` | QA cycling until goals are met |
85
+
86
+ ### Planning Modes
87
+
88
+ | Skill | Purpose |
89
+ |-------|---------|
90
+ | `$plan` | Strategic planning with optional interviews |
91
+ | `$deep-interview` | Socratic clarification before execution |
92
+ | `$ralplan` | Consensus planning with Architect + Critic review |
93
+
94
+ ### Utility Modes
95
+
96
+ | Skill | Purpose |
97
+ |-------|---------|
98
+ | `$code-review` | Comprehensive code review |
99
+ | `$security-review` | Security audit |
100
+ | `$doctor` | Diagnose and fix installation issues |
101
+ | `$trace` | Agent flow trace and summary |
102
+ | `$note` | Save session notes |
103
+ | `$wiki` | Persistent project wiki |
104
+
105
+ ---
106
+
107
+ ## Team モード
108
+
109
+ tmux-first multi-worker orchestration with persistent state and lifecycle controls.
110
+
111
+ ```bash
112
+ omp team run --task "review src/ for reliability gaps" --workers 4
113
+ omp team status --team omp --json
114
+ omp team resume --team omp
115
+ omp team shutdown --team omp --force
116
+ ```
117
+
118
+ GitHub Copilot CLI では、team モードが `.copilot/` 配下のエージェントとスキルを同期し、ターミナル worker は永続的な OMX/OMP 状態で連携します。実装、検証、ドキュメント、リリースを分け、各レーンの証跡を確認してからブランチを進めたいときに使います。
41
119
 
42
120
  ---
43
121
 
44
122
  ## ドキュメント
45
123
 
46
- - [AGENTS.md](./AGENTS.md) - エージェント登録と委任ルール
47
- - [spec/](./spec/) - コンポーネント仕様
124
+ - [Full Documentation](https://github.com/r3dlex/oh-my-githubcopilot#readme)
125
+ - [GitHub Repository](https://github.com/r3dlex/oh-my-githubcopilot)
126
+ - [Issues](https://github.com/r3dlex/oh-my-githubcopilot/issues)
127
+ - [Security Policy](https://github.com/r3dlex/oh-my-githubcopilot/security)
48
128
 
49
129
  ---
50
130
 
51
131
  ## ライセンス
52
132
 
53
- MIT
133
+ omp is open source under the [Apache-2.0 License](LICENSE).
134
+
135
+ ---
136
+
137
+ ## スポンサー
138
+
139
+ If omp saves you time, consider [sponsoring the project](https://github.com/sponsors/r3dlex) ❤️
package/README.ko.md CHANGED
@@ -1,53 +1,139 @@
1
- [English](README.md) | [Deutsch](README.de.md) | [Español](README.es.md) | [Français](README.fr.md) | [Italiano](README.it.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Português](README.pt.md) | [Русский](README.ru.md) | [Türkçe](README.tr.md) | [Tiếng Việt](README.vi.md) | [中文](README.zh.md)
1
+ # oh-my-githubcopilot (omp)
2
2
 
3
- # oh-my-githubcopilot
4
- <p align="center">
5
- <img src="assets/omp-banner.png" alt="Oh My Copilot" width="100%"/>
6
- </p>
3
+ > **Sister projects:** [oh-my-claudecode (OMC)](https://github.com/Yeachan-Heo/oh-my-claudecode) | [oh-my-codex (OMX)](https://github.com/Yeachan-Heo/oh-my-codex) | [oh-my-githubcopilot (OMP)](https://github.com/r3dlex/oh-my-githubcopilot) | [oh-my-antigravity (OMG)](https://github.com/r3dlex/oh-my-antigravity) | [oh-my-auggie (OMA)](https://github.com/r3dlex/oh-my-auggie)
7
4
 
8
- [![npm version](https://img.shields.io/npm/v/oh-my-githubcopilot?color=cb3837)](https://www.npmjs.com/package/oh-my-githubcopilot)
9
- [![npm downloads](https://img.shields.io/npm/dm/oh-my-githubcopilot?color=blue)](https://www.npmjs.com/package/oh-my-githubcopilot)
10
- [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
5
+ **GitHub Copilot CLI를 위한 멀티 에이전트 오케스트레이션. 학습 곡선은 없습니다.**
11
6
 
12
- **Oh-My-Copilot (OMP)** 은 GitHub Copilot 모던한 워크플로 오케스트레이션과 에이전트 AI 기능을 추가하는 플러그인 및 확장 기능입니다.
7
+ _GitHub Copilot CLI를 새로 배우지 마세요. 그냥 omp를 쓰세요._
8
+
9
+ [Get Started](#quick-start) • [CLI Reference](#cli-reference) • [Workflows](#workflows) • [Discord](https://discord.gg/PUwSMR9XNk)
13
10
 
14
- <p align="center">
15
- <img src="assets/buddy-swarm.png" alt="OMP swarm mode" width="600"/>
16
- </p>
17
11
  ---
18
12
 
13
+ ## 왜 omp인가요?
14
+
15
+ 모든 소프트웨어 팀은 구현, 아키텍처, 보안 리뷰, 테스트, DevOps를 동시에 다룹니다. omp는 전문 에이전트를 병렬로 오케스트레이션해 각 영역이 전문가의 관심을 받도록 합니다.
16
+
17
+ GitHub Copilot은 이미 많은 개발자가 도움을 요청하는 곳입니다. omp는 그 표면을 조율된 엔지니어링 팀으로 바꿉니다. Copilot용 에이전트, 스킬, 훅, MCP 설정, HUD 상태를 하나의 예측 가능한 워크플로로 묶어 프롬프트에서 검증된 결과까지 이어 줍니다.
18
+
19
+ ---
20
+
21
+ <a id="quick-start"></a>
19
22
  ## 빠른 시작
20
23
 
21
24
  ```bash
22
- # 설치
23
25
  npm install -g oh-my-githubcopilot
26
+ omp setup --scope project
27
+ omp
28
+ ```
24
29
 
25
- # 설정
26
- omp setup
30
+ 설정 후 `/` 명령이 보이도록 CLI를 다시 시작하세요.
31
+
32
+ ```bash
33
+ omp doctor # check prerequisites
34
+ omp team run --task "..." --workers 2 # parallel work
35
+ omp hud --watch # live status
27
36
  ```
28
- <p align="center">
29
- <img src="assets/buddy-playful.png" alt="OMP in action" width="600"/>
30
- </p>
31
37
 
32
38
  ---
33
39
 
34
40
  ## 기능
35
41
 
36
- - **멀티 에이전트 오케스트레이션** - 다양한 작업을 위한 18개의 전문 에이전트
37
- - **MCP 서버 통합** - 외부 서비스 및 도구 연결
38
- - **HUD 디스플레이** - 실시간 상태 컨텍스트 추적
39
- - **Plugin State Manager** - 세션 전반의 신뢰할 있는 상태 관리
40
- - **30+ 스킬** - 확장 기능의 지연 로딩
42
+ | Feature | Description |
43
+ |---------|-------------|
44
+ | **Specialized Agents** | 23+ agents (analyst, architect, executor, debugger, critic, verifier, test-engineer, writer, and more) |
45
+ | **Parallel Team Mode** | tmux-based multi-worker orchestration with shared task state |
46
+ | **Workflow Skills** | 39 skills built in — plan, deep-interview, ralph, autopilot, ultrawork, code-review, and more |
47
+ | **Persistent Hooks** | Automatic tool tracking, project memory, session management |
48
+ | **Real-time HUD** | Live status overlay showing agents, costs, and progress |
49
+ | **CI/CD Ready** | Verification gates, test integration, release workflows |
50
+ | **Multilingual** | README in 12 languages |
51
+
52
+ ---
53
+
54
+ <a id="cli-reference"></a>
55
+ ## CLI 참고
56
+
57
+ | Command | Description |
58
+ |---------|-------------|
59
+ | `omp` | Launch interactive session |
60
+ | `omp setup` | Configure GitHub Copilot CLI integration |
61
+ | `omp doctor` | Check prerequisites and fix issues |
62
+ | `omp team run` | Start parallel team execution |
63
+ | `omp team status` | Check team progress |
64
+ | `omp hud --watch` | Show live status overlay |
65
+ | `omp trace` | Show execution trace |
66
+
67
+ See the [full documentation](https://github.com/r3dlex/oh-my-githubcopilot#readme) for all commands.
68
+
69
+ ---
70
+
71
+ <a id="workflows"></a>
72
+ ## 워크플로
73
+
74
+ omp ships execution-mode and planning-mode workflows as built-in skills.
75
+
76
+ ### Execution Modes
77
+
78
+ | Skill | Purpose |
79
+ |-------|---------|
80
+ | `$autopilot` | Idea → working code end-to-end |
81
+ | `$team` | N coordinated agents on a shared task |
82
+ | `$ralph` | Persistent completion loop until verified |
83
+ | `$ultrawork` | Maximum parallel throughput execution |
84
+ | `$ultraqa` | QA cycling until goals are met |
85
+
86
+ ### Planning Modes
87
+
88
+ | Skill | Purpose |
89
+ |-------|---------|
90
+ | `$plan` | Strategic planning with optional interviews |
91
+ | `$deep-interview` | Socratic clarification before execution |
92
+ | `$ralplan` | Consensus planning with Architect + Critic review |
93
+
94
+ ### Utility Modes
95
+
96
+ | Skill | Purpose |
97
+ |-------|---------|
98
+ | `$code-review` | Comprehensive code review |
99
+ | `$security-review` | Security audit |
100
+ | `$doctor` | Diagnose and fix installation issues |
101
+ | `$trace` | Agent flow trace and summary |
102
+ | `$note` | Save session notes |
103
+ | `$wiki` | Persistent project wiki |
104
+
105
+ ---
106
+
107
+ ## Team 모드
108
+
109
+ tmux-first multi-worker orchestration with persistent state and lifecycle controls.
110
+
111
+ ```bash
112
+ omp team run --task "review src/ for reliability gaps" --workers 4
113
+ omp team status --team omp --json
114
+ omp team resume --team omp
115
+ omp team shutdown --team omp --force
116
+ ```
117
+
118
+ GitHub Copilot CLI에서 team 모드는 `.copilot/`의 에이전트와 스킬 자산을 동기화하고 터미널 워커는 지속적인 OMX/OMP 상태로 조율됩니다. 구현, 검증, 문서화, 릴리스 레인이 분리되어야 하고 브랜치를 진행하기 전에 각 레인의 증거가 필요할 때 사용하세요.
41
119
 
42
120
  ---
43
121
 
44
122
  ## 문서
45
123
 
46
- - [AGENTS.md](./AGENTS.md) - 에이전트 등록 및 위임 규칙
47
- - [spec/](./spec/) - 컴포넌트 사양
124
+ - [Full Documentation](https://github.com/r3dlex/oh-my-githubcopilot#readme)
125
+ - [GitHub Repository](https://github.com/r3dlex/oh-my-githubcopilot)
126
+ - [Issues](https://github.com/r3dlex/oh-my-githubcopilot/issues)
127
+ - [Security Policy](https://github.com/r3dlex/oh-my-githubcopilot/security)
48
128
 
49
129
  ---
50
130
 
51
131
  ## 라이선스
52
132
 
53
- MIT
133
+ omp is open source under the [Apache-2.0 License](LICENSE).
134
+
135
+ ---
136
+
137
+ ## 스폰서
138
+
139
+ If omp saves you time, consider [sponsoring the project](https://github.com/sponsors/r3dlex) ❤️
package/README.md CHANGED
@@ -1,139 +1,140 @@
1
- # oh-my-githubcopilot (OMP)
1
+ # oh-my-githubcopilot (omp)
2
2
 
3
- <p align="center">
4
- <img src="assets/omp-banner.png" alt="Oh My Copilot" width="100%"/>
5
- </p>
3
+ > **Sister projects:** [oh-my-claudecode (OMC)](https://github.com/Yeachan-Heo/oh-my-claudecode) | [oh-my-codex (OMX)](https://github.com/Yeachan-Heo/oh-my-codex) | [oh-my-githubcopilot (OMP)](https://github.com/r3dlex/oh-my-githubcopilot) | [oh-my-antigravity (OMG)](https://github.com/r3dlex/oh-my-antigravity) | [oh-my-auggie (OMA)](https://github.com/r3dlex/oh-my-auggie)
6
4
 
7
- <p align="center">
8
- Multi-agent orchestration for GitHub Copilot CLI — powered by 23 specialized agents, 25 skills, and a real-time HUD.
9
- </p>
5
+ **Multi-agent orchestration for GitHub Copilot CLI. Zero learning curve.**
10
6
 
11
- [![npm version](https://img.shields.io/npm/v/oh-my-githubcopilot?color=red)](https://npmjs.com/package/oh-my-githubcopilot)
12
- [![npm downloads](https://img.shields.io/npm/dm/oh-my-githubcopilot?color=blue)](https://npmjs.com/package/oh-my-githubcopilot)
13
- [![License: MIT](https://img.shields.io/npm/l/oh-my-githubcopilot?color=green)](LICENSE)
14
- [![Sponsor](https://img.shields.io/static/v1?label=Sponsor&message=r3dlex&color=EA4949&logo=github-sponsors)](https://github.com/sponsors/r3dlex)
7
+ _Don't learn GitHub Copilot CLI. Just use omp._
8
+
9
+ [Get Started](#quick-start) • [CLI Reference](#cli-reference) • [Workflows](#workflows) • [Discord](https://discord.gg/PUwSMR9XNk)
15
10
 
16
11
  ---
17
12
 
18
- ## Why OMP?
13
+ ## Why omp?
19
14
 
20
- Every software team juggles implementation, architecture, security review, testing, and DevOps — all simultaneously. OMP orchestrates specialized agents so every dimension gets expert attention, in parallel, without you herding cats.
15
+ Every software team juggles implementation, architecture, security review, testing, and DevOps — all simultaneously. omp orchestrates specialized agents so every dimension gets expert attention, in parallel, without you herding cats.
21
16
 
22
- | What you get | Why it matters |
23
- |--------------|----------------|
24
- | **23 agents** | Executor, architect, planner, reviewer, debugger, designer, security-reviewer, scientist, analyst, and more — each tuned to a different craft |
25
- | **25 skills** | `autopilot`, `ralph`, `ultrawork`, `team`, `ecomode`, `swarm`, `pipeline`, `plan` — trigger with a slash command |
26
- | **6 hooks** | Keyword detection, delegation routing, model selection, token tracking, HUD emission, stop-continuation |
27
- | **MCP server** | 10 built-in tools for extended capabilities |
28
- | **HUD display** | Real-time session context and progress tracking |
29
- | **PSM** | Plugin State Manager with SQLite persistence across sessions |
30
- | **SWE-bench** | Benchmark harness for reproducible evaluation |
17
+ GitHub Copilot is already where many developers ask for help; omp turns that surface into a coordinated engineering team. It keeps Copilot-facing agents, skills, hooks, MCP setup, and HUD state in one predictable workflow so you can move from prompt to verified delivery without hand-wiring the orchestration layer.
31
18
 
32
- <p align="center">
33
- <img src="assets/buddy-swarm.png" alt="OMP swarm mode" width="600"/>
34
- </p>
19
+ ---
35
20
 
36
21
  ## Quick Start
37
22
 
38
23
  ```bash
39
- # Install
40
24
  npm install -g oh-my-githubcopilot
25
+ omp setup --scope project
26
+ omp
27
+ ```
41
28
 
42
- # Initialize (creates ~/.omp/ config)
43
- omp setup
29
+ After setup, restart your CLI for the `/` commands to appear.
44
30
 
45
- # Start using OMP skills
46
- /omp-setup
31
+ ```bash
32
+ omp doctor # check prerequisites
33
+ omp team run --task "..." --workers 2 # parallel work
34
+ omp hud --watch # live status
47
35
  ```
48
36
 
49
- <p align="center">
50
- <img src="assets/buddy-playful.png" alt="OMP in action" width="600"/>
51
- </p>
37
+ ---
52
38
 
53
- ## Architecture
39
+ ## Features
54
40
 
55
- ```
56
- ┌─────────────────────────────────────────────────────────┐
57
- │ oh-my-githubcopilot │
58
- ├─────────────────────────────────────────────────────────┤
59
- │ Agents │ Hooks │ PSM (SQLite) │
60
- │ ───────────── │ ────────── │ ────────────── │
61
- │ executor │ keyword- │ Cross-session │
62
- │ architect │ detector │ state persistence │
63
- │ planner │ delegation- │ │
64
- │ reviewer │ enforcer │ MCP Server │
65
- │ debugger │ model-router │ ───────────── │
66
- │ ... (23 total) │ token-tracker│ 10 tools exposed │
67
- │ │ hud-emitter │ │
68
- │ │ stop-contin. │ HUD Display │
69
- ├─────────────────┴───────────────┴─────────────────────┤
70
- │ ~/.omp/ (user) + .omp/ (workspace) configs │
71
- └─────────────────────────────────────────────────────────┘
72
- ```
41
+ | Feature | Description |
42
+ |---------|-------------|
43
+ | **Specialized Agents** | 23+ agents (analyst, architect, executor, debugger, critic, verifier, test-engineer, writer, and more) |
44
+ | **Parallel Team Mode** | tmux-based multi-worker orchestration with shared task state |
45
+ | **Workflow Skills** | 39 skills built in — plan, deep-interview, ralph, autopilot, ultrawork, code-review, and more |
46
+ | **Persistent Hooks** | Automatic tool tracking, project memory, session management |
47
+ | **Real-time HUD** | Live status overlay showing agents, costs, and progress |
48
+ | **CI/CD Ready** | Verification gates, test integration, release workflows |
49
+ | **Multilingual** | README in 12 languages |
50
+
51
+ ---
52
+
53
+ ## CLI Reference
54
+
55
+ | Command | Description |
56
+ |---------|-------------|
57
+ | `omp` | Launch interactive session |
58
+ | `omp setup` | Configure GitHub Copilot CLI integration |
59
+ | `omp doctor` | Check prerequisites and fix issues |
60
+ | `omp team run` | Start parallel team execution |
61
+ | `omp team status` | Check team progress |
62
+ | `omp hud --watch` | Show live status overlay |
63
+ | `omp trace` | Show execution trace |
73
64
 
74
- ### Agents
65
+ See the [full documentation](https://github.com/r3dlex/oh-my-githubcopilot#readme) for all commands.
75
66
 
76
- OMP provides 23 specialized agents via Claude Code subagents:
67
+ ---
68
+
69
+ ## Workflows
70
+
71
+ omp ships execution-mode and planning-mode workflows as built-in skills.
77
72
 
78
- | Agent | Tier | Use Case |
79
- |-------|------|----------|
80
- | executor | opus | Implementation, testing |
81
- | architect | opus | Architecture, security |
82
- | planner | sonnet | Strategic planning |
83
- | document-specialist | sonnet | Documentation |
84
- | reviewer | sonnet | Code review |
85
- | verifier | sonnet | Verification |
73
+ ### Execution Modes
86
74
 
87
- _See [AGENTS.md](AGENTS.md) for the full registry._
75
+ | Skill | Purpose |
76
+ |-------|---------|
77
+ | `$autopilot` | Idea → working code end-to-end |
78
+ | `$team` | N coordinated agents on a shared task |
79
+ | `$ralph` | Persistent completion loop until verified |
80
+ | `$ultrawork` | Maximum parallel throughput execution |
81
+ | `$ultraqa` | QA cycling until goals are met |
88
82
 
89
- ### Hooks
83
+ ### Planning Modes
90
84
 
91
- Six hooks power the orchestration pipeline:
85
+ | Skill | Purpose |
86
+ |-------|---------|
87
+ | `$plan` | Strategic planning with optional interviews |
88
+ | `$deep-interview` | Socratic clarification before execution |
89
+ | `$ralplan` | Consensus planning with Architect + Critic review |
92
90
 
93
- - **keyword-detector** — triggers OMP skills on magic keywords
94
- - **delegation-enforcer** — routes tasks to appropriate agents
95
- - **model-router** selects optimal model tier per task
96
- - **token-tracker** — monitors usage and cost
97
- - **hud-emitter** streams session context to HUD
98
- - **stop-continuation** graceful cancellation handling
91
+ ### Utility Modes
92
+
93
+ | Skill | Purpose |
94
+ |-------|---------|
95
+ | `$code-review` | Comprehensive code review |
96
+ | `$security-review` | Security audit |
97
+ | `$doctor` | Diagnose and fix installation issues |
98
+ | `$trace` | Agent flow trace and summary |
99
+ | `$note` | Save session notes |
100
+ | `$wiki` | Persistent project wiki |
101
+
102
+ ---
99
103
 
100
- ### PSM (Plugin State Manager)
104
+ ## Team Mode
101
105
 
102
- Cross-session persistence via SQLite:
106
+ tmux-first multi-worker orchestration with persistent state and lifecycle controls.
103
107
 
104
- ```javascript
105
- // State persists across sessions
106
- await state.write({ mode: 'autopilot', iteration: 3 });
107
- const state = await state.read();
108
+ ```bash
109
+ omp team run --task "review src/ for reliability gaps" --workers 4
110
+ omp team status --team omp --json
111
+ omp team resume --team omp
112
+ omp team shutdown --team omp --force
108
113
  ```
109
114
 
110
- ### MCP Server
115
+ For GitHub Copilot CLI, team mode keeps `.copilot/` agent and skill assets synchronized while terminal workers coordinate through durable OMX/OMP state. Use it when a Copilot task needs separate implementation, verification, documentation, or release lanes and you want each lane to report evidence before the branch moves forward.
111
116
 
112
- 10 tools exposed for extended capabilities. See [spec/MCP.md](spec/MCP.md).
117
+ ---
113
118
 
114
119
  ## Documentation
115
120
 
116
- - [AGENTS.md](AGENTS.md) — Agent registry and delegation rules
117
- - [spec/AGENTS_SPEC.md](spec/AGENTS_SPEC.md) — Agent capabilities table
118
- - [spec/SKILLS.md](spec/SKILLS.md) — Skill catalog
119
- - [spec/HOOKS.md](spec/HOOKS.md) — Hook system
120
- - [spec/HUD.md](spec/HUD.md) — HUD display
121
- - [spec/PSM.md](spec/PSM.md) — Plugin State Manager
122
- - [spec/MCP.md](spec/MCP.md) — MCP server
121
+ - [Full Documentation](https://github.com/r3dlex/oh-my-githubcopilot#readme)
122
+ - [GitHub Repository](https://github.com/r3dlex/oh-my-githubcopilot)
123
+ - [Issues](https://github.com/r3dlex/oh-my-githubcopilot/issues)
124
+ - [Security Policy](https://github.com/r3dlex/oh-my-githubcopilot/security)
123
125
 
124
- ## Requirements
126
+ ---
125
127
 
126
- - Node.js >= 22.0.0
127
- - GitHub Copilot CLI
128
+ ## License
128
129
 
129
- ---
130
+ omp is open source under the [Apache-2.0 License](LICENSE).
130
131
 
131
- ## 💛 Love this project? [Sponsor r3dlex](https://github.com/sponsors/r3dlex)
132
+ ---
132
133
 
133
- If OMP saves you time, consider sponsoring the maintainer:
134
+ ## Star History
134
135
 
135
- [![Sponsor r3dlex](https://github.githubassets.com/assets/images/modules/sponsors/modules/SponsorButton--glyph-sm-b5211212fc9306694a295e37672660c1.gif)](https://github.com/sponsors/r3dlex)
136
+ [![Star History Chart](https://api.star-history.com/chart?repos=r3dlex/oh-my-githubcopilot&type=date&legend=top-left)](https://www.star-history.com/?repos=r3dlex%2Foh-my-githubcopilot&type=date&legend=top-left)
136
137
 
137
- Every sponsorship helps keep development going.
138
+ ## Sponsors
138
139
 
139
- MIT License | [GitHub](https://github.com/r3dlex/oh-my-githubcopilot)
140
+ If omp saves you time, consider [sponsoring the project](https://github.com/sponsors/r3dlex) ❤️