orcastrator 0.2.9 → 0.2.11
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 +19 -10
- package/dist/agents/claude/session.js +5 -2
- package/dist/agents/codex/session.js +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,4 +1,10 @@
|
|
|
1
|
-
|
|
1
|
+
<p align="center">
|
|
2
|
+
<img src="assets/orca-banner.jpg" alt="Orca" width="380" />
|
|
3
|
+
<br/><br/>
|
|
4
|
+
<a href="https://orcastrator.dev">orcastrator.dev</a>
|
|
5
|
+
</p>
|
|
6
|
+
|
|
7
|
+
# Orca
|
|
2
8
|
|
|
3
9
|
Coordinated agent run harness. Breaks down a goal into a task graph, then executes it end-to-end via a persistent [Codex](https://github.com/ratley/codex-client) session with full context across tasks.
|
|
4
10
|
|
|
@@ -36,9 +42,9 @@ orca plan --spec ./specs/feature.md
|
|
|
36
42
|
## Run Management
|
|
37
43
|
|
|
38
44
|
```bash
|
|
39
|
-
orca status
|
|
40
|
-
orca status --last
|
|
41
|
-
orca status --run <run-id>
|
|
45
|
+
orca status # list all runs (summary table)
|
|
46
|
+
orca status --last # status of the most recent run
|
|
47
|
+
orca status --run <run-id> # status of a specific run
|
|
42
48
|
|
|
43
49
|
orca list
|
|
44
50
|
|
|
@@ -60,7 +66,7 @@ orca pr create --run <run-id>
|
|
|
60
66
|
orca pr publish --run <run-id>
|
|
61
67
|
orca pr status --run <run-id>
|
|
62
68
|
|
|
63
|
-
orca pr
|
|
69
|
+
orca pr publish --config ./orca.config.js
|
|
64
70
|
```
|
|
65
71
|
|
|
66
72
|
## Config
|
|
@@ -94,7 +100,7 @@ export default {
|
|
|
94
100
|
|
|
95
101
|
Codex supports experimental [multi-agent workflows](https://developers.openai.com/codex/multi-agent) where it can spawn parallel sub-agents for complex tasks.
|
|
96
102
|
|
|
97
|
-
To enable it in
|
|
103
|
+
To enable it in Orca, set `codex.multiAgent: true` in your config:
|
|
98
104
|
|
|
99
105
|
```js
|
|
100
106
|
export default {
|
|
@@ -102,7 +108,7 @@ export default {
|
|
|
102
108
|
};
|
|
103
109
|
```
|
|
104
110
|
|
|
105
|
-
When enabled,
|
|
111
|
+
When enabled, Orca adds `multi_agent = true` to your global `~/.codex/config.toml`. If you already have multi-agent enabled in your Codex config, it will work automatically without setting anything in Orca.
|
|
106
112
|
|
|
107
113
|
> **Note:** Multi-agent is off by default because enabling it modifies your global Codex configuration. It is currently an experimental Codex feature.
|
|
108
114
|
|
|
@@ -132,8 +138,6 @@ Global:
|
|
|
132
138
|
|
|
133
139
|
- `--spec <path>`
|
|
134
140
|
- `--config <path>`
|
|
135
|
-
- `--on-milestone <cmd>`
|
|
136
|
-
- `--on-error <cmd>`
|
|
137
141
|
|
|
138
142
|
`orca status`:
|
|
139
143
|
|
|
@@ -168,7 +172,7 @@ Global:
|
|
|
168
172
|
- `--last`
|
|
169
173
|
- `--config <path>`
|
|
170
174
|
|
|
171
|
-
`orca pr
|
|
175
|
+
`orca pr publish`:
|
|
172
176
|
|
|
173
177
|
- `--config <path>`
|
|
174
178
|
|
|
@@ -180,6 +184,11 @@ Global:
|
|
|
180
184
|
- `--global`
|
|
181
185
|
- `--project`
|
|
182
186
|
|
|
187
|
+
`orca help`:
|
|
188
|
+
|
|
189
|
+
- positional: `[command]` — show help for a specific command (e.g. `orca help plan`)
|
|
190
|
+
- no flags; also works as `orca --help` or `orca <command> --help`
|
|
191
|
+
|
|
183
192
|
### Hooks
|
|
184
193
|
|
|
185
194
|
Hook names:
|
|
@@ -51,7 +51,9 @@ function extractAssistantText(message) {
|
|
|
51
51
|
return text.length > 0 ? text : null;
|
|
52
52
|
}
|
|
53
53
|
export function parseTaskArray(raw) {
|
|
54
|
-
|
|
54
|
+
// Strip markdown fences if present (defensive fallback)
|
|
55
|
+
const stripped = raw.trim().replace(/^```(?:json)?\s*/i, "").replace(/\s*```\s*$/i, "");
|
|
56
|
+
const parsed = JSON.parse(stripped);
|
|
55
57
|
if (!Array.isArray(parsed)) {
|
|
56
58
|
throw new Error("Claude plan response was not a JSON array");
|
|
57
59
|
}
|
|
@@ -121,7 +123,8 @@ function getModel(config) {
|
|
|
121
123
|
}
|
|
122
124
|
export async function planSpec(spec, systemContext, config) {
|
|
123
125
|
const session = unstable_v2_createSession({
|
|
124
|
-
model: getModel(config)
|
|
126
|
+
model: getModel(config),
|
|
127
|
+
permissionMode: "bypassPermissions",
|
|
125
128
|
});
|
|
126
129
|
try {
|
|
127
130
|
const streamPromise = collectSessionResult(session);
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "orcastrator",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.11",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"bin": {
|
|
6
6
|
"orca": "dist/cli/index.js"
|
|
@@ -18,9 +18,9 @@
|
|
|
18
18
|
"dependencies": {
|
|
19
19
|
"@anthropic-ai/claude-agent-sdk": "^0.2.47",
|
|
20
20
|
"@inquirer/prompts": "^8.2.1",
|
|
21
|
+
"@ratley/codex-client": "^0.1.3",
|
|
21
22
|
"chalk": "^5.3.0",
|
|
22
23
|
"commander": "^13.1.0",
|
|
23
|
-
"orca-codex-client": "^0.1.3",
|
|
24
24
|
"zod": "^3.24.1"
|
|
25
25
|
},
|
|
26
26
|
"devDependencies": {
|