opencode-orchestrator 0.5.5 โ 0.5.7
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.
- package/README.md +24 -176
- package/dist/index.js +18 -13
- package/package.json +3 -2
package/README.md
CHANGED
|
@@ -11,34 +11,20 @@
|
|
|
11
11
|
|
|
12
12
|
---
|
|
13
13
|
|
|
14
|
-
## Why I Built This ๐ค
|
|
15
|
-
|
|
16
|
-
**I was frustrated coding with DeepSeek and Z.AI.**
|
|
17
|
-
|
|
18
|
-
I wanted to achieve the same quality of work as premium models like **Gemini 3 Pro** and **Claude Opus**, but with affordable models.
|
|
19
|
-
For developers who chose **budget-friendly subscriptions** instead of expensive plans, I built a multi-agent system that can **autonomously complete** complex engineering tasks even with mid-tier LLMs.
|
|
20
|
-
|
|
21
|
-
> *"Intelligence is a resource. Orchestrate it."*
|
|
22
|
-
|
|
23
|
-
---
|
|
24
|
-
|
|
25
14
|
## What is this?
|
|
26
15
|
|
|
27
|
-
A **5-agent autonomous architecture**
|
|
28
|
-
|
|
29
|
-
**Core Philosophy**: Intelligence is a resource. We orchestrate that resource through **Phase-based Workflows** and **Mandatory Environment Scans** to ensure code always fits the project's infrastructure.
|
|
16
|
+
A **5-agent autonomous architecture** for OpenCode that completes complex engineering tasks reliably.
|
|
30
17
|
|
|
31
|
-
>
|
|
18
|
+
> *"Intelligence is a resource. Orchestrate it."*
|
|
32
19
|
|
|
33
20
|
### Key Features
|
|
34
|
-
- **๐ฏ Autonomous Loop** โ Commander runs
|
|
35
|
-
- **๐ Environment Scan** โ
|
|
36
|
-
- **๐จ Smart Implementation** โ
|
|
37
|
-
- **๐ก๏ธ Rigorous Audit** โ
|
|
38
|
-
- **๐พ Persistent Context** โ
|
|
39
|
-
- **๐๏ธ Parallel Agents** โ
|
|
40
|
-
- **โณ Background Tasks** โ
|
|
41
|
-
- **๐ mgrep** โ Multi-pattern parallel search powered by Rust for blazing-fast codebase analysis.
|
|
21
|
+
- **๐ฏ Autonomous Loop** โ Commander runs until the mission is complete
|
|
22
|
+
- **๐ Environment Scan** โ Analyzes Infra, Stack, and Domain before coding
|
|
23
|
+
- **๐จ Smart Implementation** โ Matches existing codebase patterns
|
|
24
|
+
- **๐ก๏ธ Rigorous Audit** โ Proves success with builds/tests/logs
|
|
25
|
+
- **๐พ Persistent Context** โ Saves session state to disk
|
|
26
|
+
- **๐๏ธ Parallel Agents** โ Run multiple agents concurrently
|
|
27
|
+
- **โณ Background Tasks** โ Non-blocking command execution
|
|
42
28
|
|
|
43
29
|
---
|
|
44
30
|
|
|
@@ -54,169 +40,33 @@ Restart OpenCode after installation.
|
|
|
54
40
|
|
|
55
41
|
## Usage
|
|
56
42
|
|
|
57
|
-
### ๐
|
|
58
|
-
|
|
59
|
-
In OpenCode, press `Tab` to open the Agent selection menu. Select **Commander** and type your mission!
|
|
43
|
+
### ๐ Select Commander via Tab Key (Recommended)
|
|
60
44
|
|
|
61
|
-
|
|
62
|
-
<img src="assets/commander-screenshot.png" alt="Commander Screenshot" width="600" />
|
|
63
|
-
<p><em>Press Tab to select Commander</em></p>
|
|
64
|
-
</div>
|
|
45
|
+
Press `Tab` in OpenCode โ Select **Commander** โ Type your mission!
|
|
65
46
|
|
|
66
47
|
```
|
|
67
48
|
"Fix the login bug in the docker-compose environment"
|
|
68
49
|
```
|
|
69
50
|
|
|
70
|
-
|
|
71
|
-
1. **Survey**: Scan the Docker environment and codebase.
|
|
72
|
-
2. **Plan**: Break the fix into steps.
|
|
73
|
-
3. **Execute**: Call Builder to fix while matching patterns.
|
|
74
|
-
4. **Verify**: Run builds/tests to prove the fix works.
|
|
75
|
-
5. **Complete**: Report results with concrete evidence.
|
|
76
|
-
|
|
77
|
-
### ๐ Method 2: Use /task Command
|
|
51
|
+
### ๐ Use /task Command
|
|
78
52
|
|
|
79
53
|
```bash
|
|
80
54
|
/task "Implement user authentication with JWT"
|
|
81
55
|
```
|
|
82
56
|
|
|
83
|
-
> **๐ก Tip:**
|
|
84
|
-
> Use `/task` for complex tasks that need extended processing!
|
|
85
|
-
|
|
86
|
-
### โก Example: Parallel Execution
|
|
87
|
-
|
|
88
|
-
Trigger parallel agent execution with prompts like:
|
|
89
|
-
|
|
90
|
-
```
|
|
91
|
-
"Build and test in parallel"
|
|
92
|
-
"Implement feature X while reviewing module Y"
|
|
93
|
-
"Run linting, tests, and build at the same time"
|
|
94
|
-
```
|
|
95
|
-
|
|
96
|
-
Commander will automatically use `delegate_task` with `background: true` for independent tasks.
|
|
97
|
-
|
|
98
|
-
Monitor parallel tasks in the terminal:
|
|
99
|
-
```
|
|
100
|
-
[parallel] ๐ SPAWNED task_a1b2 โ builder: Implement feature X
|
|
101
|
-
[parallel] ๐ SPAWNED task_c3d4 โ inspector: Review module Y
|
|
102
|
-
[parallel] โ
COMPLETED task_c3d4 โ inspector: Review module Y (45s)
|
|
103
|
-
[parallel] ๐๏ธ CLEANED task_c3d4 (session deleted)
|
|
104
|
-
```
|
|
57
|
+
> **๐ก Tip:** `/task` makes Commander run **2x longer** for complex tasks.
|
|
105
58
|
|
|
106
59
|
---
|
|
107
60
|
|
|
108
|
-
##
|
|
109
|
-
|
|
110
|
-
| Agent | Emoji | Role | Responsibility |
|
|
111
|
-
| :--- | :--- | :--- | :--- |
|
|
112
|
-
| **Commander** | ๐ฏ | Orchestrator | Autonomous mission control & delegation |
|
|
113
|
-
| **Architect** | ๐๏ธ | Planner | Task decomposition & strategy correction |
|
|
114
|
-
| **Builder** | ๐จ | Developer | Full-stack implementation (Logic + UI) |
|
|
115
|
-
| **Inspector** | ๐ | Quality | 5-point audit & automatic bug fixing |
|
|
116
|
-
| **Recorder** | ๐พ | Context | Persistent environment & progress tracking |
|
|
117
|
-
|
|
118
|
-
---
|
|
119
|
-
|
|
120
|
-
## The Workflow (Progressive Phases)
|
|
121
|
-
|
|
122
|
-
1. **Phase 0: Triage (Smart)**
|
|
123
|
-
- **Fast Track ๐ข**: Simple fixes โ Execute instantly (Skip heavy scans).
|
|
124
|
-
- **Deep Track ๐ด**: Complex features โ Full Environment Scan & Plan.
|
|
125
|
-
2. **Phase 1: Environment Scan**
|
|
126
|
-
- Mandatory for Deep Track: Infra/Domain/Stack analysis.
|
|
127
|
-
3. **Phase 2: Parallel Planning**
|
|
128
|
-
- Architect creates a DAG of atomic tasks (Scalable Planning).
|
|
129
|
-
4. **Phase 3: Execution & Audit**
|
|
130
|
-
- Builder writes code โ Inspector verifies with evidence.
|
|
131
|
-
5. **Phase 4: Completion**
|
|
132
|
-
- Mission Complete reported with proof of build/test success.
|
|
133
|
-
|
|
134
|
-
---
|
|
135
|
-
|
|
136
|
-
## Development
|
|
137
|
-
|
|
138
|
-
### Quick Start (Local Development)
|
|
139
|
-
|
|
140
|
-
```bash
|
|
141
|
-
# Step 1: Build and link (run this ONCE)
|
|
142
|
-
npm run dev:link
|
|
143
|
-
|
|
144
|
-
# Step 2: Restart OpenCode
|
|
145
|
-
|
|
146
|
-
# Step 3: Make code changes...
|
|
147
|
-
|
|
148
|
-
# Step 4: Rebuild and re-link (after code changes)
|
|
149
|
-
npm run dev:link
|
|
150
|
-
|
|
151
|
-
# (Optional) Check link status
|
|
152
|
-
npm run dev:status
|
|
153
|
-
```
|
|
154
|
-
|
|
155
|
-
### Development Scripts
|
|
156
|
-
|
|
157
|
-
```bash
|
|
158
|
-
# Build the plugin
|
|
159
|
-
npm run build
|
|
160
|
-
|
|
161
|
-
# Link for local testing (auto-rebuilds)
|
|
162
|
-
npm run dev:link
|
|
163
|
-
|
|
164
|
-
# Unlink from global
|
|
165
|
-
npm run dev:unlink
|
|
166
|
-
|
|
167
|
-
# Check if plugin is linked globally
|
|
168
|
-
npm run dev:status
|
|
169
|
-
|
|
170
|
-
# Test install/uninstall scripts locally
|
|
171
|
-
npm run dev:test
|
|
172
|
-
```
|
|
173
|
-
|
|
174
|
-
### Development Workflow
|
|
175
|
-
|
|
176
|
-
| Step | Command | Description |
|
|
177
|
-
|------|----------|-------------|
|
|
178
|
-
| 1๏ธโฃ Initial setup | `npm run dev:link` | Build + link for the first time |
|
|
179
|
-
| 2๏ธโฃ Test | Open OpenCode | Test your changes |
|
|
180
|
-
| 3๏ธโฃ Make changes | Edit code | Modify TypeScript files |
|
|
181
|
-
| 4๏ธโฃ Rebuild | `npm run dev:link` | Rebuild + re-link |
|
|
182
|
-
| 5๏ธโฃ Repeat | 2-4 | Iterate on changes |
|
|
183
|
-
| โ Cleanup | `npm run dev:unlink` | Unlink when done |
|
|
184
|
-
|
|
185
|
-
### Common Scenarios
|
|
186
|
-
|
|
187
|
-
```bash
|
|
188
|
-
# ๐ Changed code and want to test
|
|
189
|
-
npm run dev:link
|
|
190
|
-
|
|
191
|
-
# ๐ Check if linked properly
|
|
192
|
-
npm run dev:status
|
|
193
|
-
|
|
194
|
-
# ๐งน Cleanup before committing
|
|
195
|
-
npm run dev:unlink
|
|
196
|
-
|
|
197
|
-
# ๐งช Test install/uninstall scripts
|
|
198
|
-
npm run dev:test
|
|
199
|
-
```
|
|
200
|
-
|
|
201
|
-
### Release Scripts
|
|
202
|
-
|
|
203
|
-
```bash
|
|
204
|
-
# Release patch version (0.4.1 โ 0.4.2)
|
|
205
|
-
npm run release:patch
|
|
206
|
-
|
|
207
|
-
# Release minor version (0.4.1 โ 0.5.0)
|
|
208
|
-
npm run release:minor
|
|
209
|
-
|
|
210
|
-
# Release major version (0.4.1 โ 1.0.0)
|
|
211
|
-
npm run release:major
|
|
212
|
-
```
|
|
61
|
+
## The 5 Agents
|
|
213
62
|
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
63
|
+
| Agent | Role | Responsibility |
|
|
64
|
+
| :--- | :--- | :--- |
|
|
65
|
+
| **Commander** ๐ฏ | Orchestrator | Autonomous mission control |
|
|
66
|
+
| **Architect** ๐๏ธ | Planner | Task decomposition |
|
|
67
|
+
| **Builder** ๐จ | Developer | Full-stack implementation |
|
|
68
|
+
| **Inspector** ๐ | Quality | Audit & auto-fix |
|
|
69
|
+
| **Recorder** ๐พ | Context | Progress tracking |
|
|
220
70
|
|
|
221
71
|
---
|
|
222
72
|
|
|
@@ -228,12 +78,10 @@ npm uninstall -g opencode-orchestrator
|
|
|
228
78
|
|
|
229
79
|
---
|
|
230
80
|
|
|
231
|
-
##
|
|
81
|
+
## Documentation
|
|
232
82
|
|
|
233
|
-
- [Architecture & Design](docs/ARCHITECTURE.md)
|
|
234
|
-
- [
|
|
235
|
-
- [Changelog](CHANGELOG.md) โ Version history and updates
|
|
236
|
-
- [Changelogs](changelogs/) โ Detailed implementation notes per release
|
|
83
|
+
- [Architecture & Design](docs/ARCHITECTURE.md)
|
|
84
|
+
- [Troubleshooting](docs/PLUGIN_TROUBLESHOOTING.md)
|
|
237
85
|
|
|
238
86
|
---
|
|
239
87
|
|
package/dist/index.js
CHANGED
|
@@ -22,11 +22,12 @@ You are Commander. Complete missions autonomously. Never stop until done.
|
|
|
22
22
|
</role>
|
|
23
23
|
|
|
24
24
|
<core_rules>
|
|
25
|
-
1.
|
|
26
|
-
2. Never
|
|
27
|
-
3. Never
|
|
28
|
-
4.
|
|
29
|
-
5. Always
|
|
25
|
+
1. LANGUAGE: ALL output MUST be in English only. No exceptions. No other languages.
|
|
26
|
+
2. Never stop until "\u2705 MISSION COMPLETE"
|
|
27
|
+
3. Never wait for user during execution
|
|
28
|
+
4. Never stop because agent returned nothing
|
|
29
|
+
5. Always survey environment & codebase BEFORE coding
|
|
30
|
+
6. Always verify with evidence based on runtime context
|
|
30
31
|
</core_rules>
|
|
31
32
|
|
|
32
33
|
<phase_0 name="TRIAGE">
|
|
@@ -216,8 +217,8 @@ You are Architect. Break complex tasks into atomic pieces.
|
|
|
216
217
|
</role>
|
|
217
218
|
|
|
218
219
|
<constraints>
|
|
219
|
-
|
|
220
|
-
If your reasoning collapses into gibberish, stop and output "ERROR: REASONING_COLLAPSE".
|
|
220
|
+
1. LANGUAGE: ALL output MUST be in English only. No exceptions. No other languages.
|
|
221
|
+
2. If your reasoning collapses into gibberish, stop and output "ERROR: REASONING_COLLAPSE".
|
|
221
222
|
</constraints>
|
|
222
223
|
|
|
223
224
|
<scalable_planning>
|
|
@@ -278,8 +279,8 @@ You are Builder. Write code that works.
|
|
|
278
279
|
</role>
|
|
279
280
|
|
|
280
281
|
<constraints>
|
|
281
|
-
|
|
282
|
-
If your reasoning collapses into gibberish, stop and output "ERROR: REASONING_COLLAPSE".
|
|
282
|
+
1. LANGUAGE: ALL output MUST be in English only. No exceptions. No other languages.
|
|
283
|
+
2. If your reasoning collapses into gibberish, stop and output "ERROR: REASONING_COLLAPSE".
|
|
283
284
|
</constraints>
|
|
284
285
|
|
|
285
286
|
<scalable_attention>
|
|
@@ -344,8 +345,8 @@ You are Inspector. Prove failure or success with evidence.
|
|
|
344
345
|
</role>
|
|
345
346
|
|
|
346
347
|
<constraints>
|
|
347
|
-
|
|
348
|
-
If your reasoning collapses into gibberish, stop and output "ERROR: REASONING_COLLAPSE".
|
|
348
|
+
1. LANGUAGE: ALL output MUST be in English only. No exceptions. No other languages.
|
|
349
|
+
2. If your reasoning collapses into gibberish, stop and output "ERROR: REASONING_COLLAPSE".
|
|
349
350
|
</constraints>
|
|
350
351
|
|
|
351
352
|
<scalable_audit>
|
|
@@ -411,8 +412,8 @@ You are Recorder. Save and load work progress.
|
|
|
411
412
|
</role>
|
|
412
413
|
|
|
413
414
|
<constraints>
|
|
414
|
-
|
|
415
|
-
If your reasoning collapses into gibberish, stop and output "ERROR: REASONING_COLLAPSE".
|
|
415
|
+
1. LANGUAGE: ALL output MUST be in English only. No exceptions. No other languages.
|
|
416
|
+
2. If your reasoning collapses into gibberish, stop and output "ERROR: REASONING_COLLAPSE".
|
|
416
417
|
</constraints>
|
|
417
418
|
|
|
418
419
|
<purpose>
|
|
@@ -13053,6 +13054,10 @@ var COMMANDS = {
|
|
|
13053
13054
|
You are Commander. Complete this mission. Never stop until 100% done.
|
|
13054
13055
|
</role>
|
|
13055
13056
|
|
|
13057
|
+
<language_rule>
|
|
13058
|
+
CRITICAL: ALL output MUST be in English only. No exceptions. No other languages permitted.
|
|
13059
|
+
</language_rule>
|
|
13060
|
+
|
|
13056
13061
|
<phase_1 name="MANDATORY_ENVIRONMENT_SCAN">
|
|
13057
13062
|
Before any planning or coding, you MUST understand:
|
|
13058
13063
|
1. INFRA: OS-native? Container? Docker-compose? Volume-mounted?
|
package/package.json
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"name": "opencode-orchestrator",
|
|
3
3
|
"displayName": "OpenCode Orchestrator",
|
|
4
4
|
"description": "Distributed Cognitive Architecture for OpenCode. Turns simple prompts into specialized multi-agent workflows (Planner, Coder, Reviewer).",
|
|
5
|
-
"version": "0.5.
|
|
5
|
+
"version": "0.5.7",
|
|
6
6
|
"author": "agnusdei1207",
|
|
7
7
|
"license": "MIT",
|
|
8
8
|
"repository": {
|
|
@@ -56,7 +56,8 @@
|
|
|
56
56
|
"dev:unlink": "npm unlink -g opencode-orchestrator || true && npm run dev:clean && echo 'SUCCESS: Unlinked'",
|
|
57
57
|
"dev:status": "echo '=== Global Link ===' && ls -la $(npm root -g)/opencode-orchestrator 2>/dev/null || echo 'Not linked'",
|
|
58
58
|
"dev:test": "node dist/scripts/postinstall.js && echo '---' && node dist/scripts/preuninstall.js",
|
|
59
|
-
"reset": "npm run dev:unlink || true && npm uninstall -g opencode-orchestrator || true && brew uninstall opencode || true && rm -rf ~/.config/opencode ~/.opencode ~/.local/share/opencode && echo '=== Clean done ===' && brew install opencode && npm run dev:link && echo '=== Reset complete ==='"
|
|
59
|
+
"reset": "npm run dev:unlink || true && npm uninstall -g opencode-orchestrator || true && brew uninstall opencode || true && rm -rf ~/.config/opencode ~/.opencode ~/.local/share/opencode && echo '=== Clean done ===' && brew install opencode && npm run dev:link && echo '=== Reset complete ==='",
|
|
60
|
+
"reset:global": "npm run dev:unlink || true && npm uninstall -g opencode-orchestrator || true && brew uninstall opencode || true && rm -rf ~/.config/opencode ~/.opencode ~/.local/share/opencode && echo '=== Clean done ===' && brew install opencode && npm install -g opencode-orchestrator && echo '=== Reset Global complete ==='"
|
|
60
61
|
},
|
|
61
62
|
"dependencies": {
|
|
62
63
|
"@opencode-ai/plugin": "^1.1.1",
|