multi-agents-cli 1.0.21 → 1.0.23
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 +7 -7
- package/init.js +11 -10
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -17,7 +17,7 @@ npm install -g multi-agents-cli
|
|
|
17
17
|
```bash
|
|
18
18
|
multi-agents init my-project
|
|
19
19
|
cd my-project
|
|
20
|
-
npm run
|
|
20
|
+
npm run agent
|
|
21
21
|
```
|
|
22
22
|
|
|
23
23
|
`multi-agents init` will:
|
|
@@ -36,7 +36,7 @@ npm run launch
|
|
|
36
36
|
### 1. Launch a task
|
|
37
37
|
|
|
38
38
|
```bash
|
|
39
|
-
npm run
|
|
39
|
+
npm run agent
|
|
40
40
|
```
|
|
41
41
|
|
|
42
42
|
Select scope → agent → describe the task (or press Enter for default) →
|
|
@@ -52,7 +52,7 @@ the tracking slot.
|
|
|
52
52
|
|
|
53
53
|
### 3. Repeat
|
|
54
54
|
|
|
55
|
-
`npm run complete` chains back to `npm run
|
|
55
|
+
`npm run complete` chains back to `npm run agent`. Pick the next agent
|
|
56
56
|
and continue building.
|
|
57
57
|
|
|
58
58
|
---
|
|
@@ -62,7 +62,7 @@ and continue building.
|
|
|
62
62
|
Choose during `multi-agents init`:
|
|
63
63
|
|
|
64
64
|
**Multi-Agent Driven Orchestration** *(recommended)*
|
|
65
|
-
Every task should start with `npm run
|
|
65
|
+
Every task should start with `npm run agent`. Each agent works in its own
|
|
66
66
|
git worktree — an isolated branch and folder that merges back into main via
|
|
67
67
|
`npm run complete`. Faster builds and lower token spend than a single long session.
|
|
68
68
|
⚠ If you commit directly to main yourself, you bypass the framework and break
|
|
@@ -225,7 +225,7 @@ The launcher enforces structural rules before any worktree is created:
|
|
|
225
225
|
|
|
226
226
|
**Status values:** `null` (never launched) · `ACTIVE` (running) · `MISSING` (worktree deleted without completing)
|
|
227
227
|
|
|
228
|
-
Managed entirely by `
|
|
228
|
+
Managed entirely by `agent.js` and `complete.js`. Never edit manually.
|
|
229
229
|
|
|
230
230
|
---
|
|
231
231
|
|
|
@@ -253,7 +253,7 @@ Written at init time. Updated by agents after scaffolding their framework.
|
|
|
253
253
|
|
|
254
254
|
## Running Commands From Anywhere
|
|
255
255
|
|
|
256
|
-
`npm run
|
|
256
|
+
`npm run agent` and `npm run complete` self-relocate to the repo root
|
|
257
257
|
via `git rev-parse --git-common-dir`. Run them from the worktree terminal,
|
|
258
258
|
the repo root, or anywhere inside the git tree — they always work.
|
|
259
259
|
|
|
@@ -280,7 +280,7 @@ my-project/
|
|
|
280
280
|
│ ├── .paths.json
|
|
281
281
|
│ └── .initialized
|
|
282
282
|
└── .workflow/
|
|
283
|
-
├──
|
|
283
|
+
├── agent.js
|
|
284
284
|
├── complete.js
|
|
285
285
|
└── guards.js
|
|
286
286
|
```
|
package/init.js
CHANGED
|
@@ -647,7 +647,7 @@ const main = async () => {
|
|
|
647
647
|
|
|
648
648
|
console.log(`\n${yellow(' This project has already been initialized.')}`);
|
|
649
649
|
console.log(dim(` Initialized on: ${ts}\n`));
|
|
650
|
-
console.log(` ${dim('1.')} Continue — run ${cyan('npm run
|
|
650
|
+
console.log(` ${dim('1.')} Continue — run ${cyan('npm run agent')}`);
|
|
651
651
|
console.log(` ${dim('2.')} Reset — delete config and re-run initialization`);
|
|
652
652
|
console.log(` ${dim('3.')} Exit\n`);
|
|
653
653
|
|
|
@@ -656,7 +656,7 @@ const main = async () => {
|
|
|
656
656
|
if (choice === '1') {
|
|
657
657
|
console.log('');
|
|
658
658
|
rl2.close();
|
|
659
|
-
const child = spawn('node', [path.join(ROOT, '.workflow', '
|
|
659
|
+
const child = spawn('node', [path.join(ROOT, '.workflow', 'agent.js')], {
|
|
660
660
|
stdio: 'inherit',
|
|
661
661
|
cwd: ROOT,
|
|
662
662
|
});
|
|
@@ -1002,6 +1002,7 @@ const main = async () => {
|
|
|
1002
1002
|
ensureGitignore('.agents-core/');
|
|
1003
1003
|
ensureGitignore('.scaffold/');
|
|
1004
1004
|
ensureGitignore('.workflow/');
|
|
1005
|
+
ensureGitignore('node_modules/');
|
|
1005
1006
|
|
|
1006
1007
|
// Remove template-specific gitignore entries so generated files can be committed
|
|
1007
1008
|
const gitignorePath = path.join(ROOT, '.gitignore');
|
|
@@ -1101,7 +1102,7 @@ ${backendType === 'integrated'
|
|
|
1101
1102
|
- [ ] LOGIC - business rules
|
|
1102
1103
|
- [ ] EVENTS - webhooks and queues
|
|
1103
1104
|
- [ ] JOBS - background tasks`
|
|
1104
|
-
: 'Not configured - run node .workflow/
|
|
1105
|
+
: 'Not configured - run node .workflow/agent.js and select backend when ready'}
|
|
1105
1106
|
|
|
1106
1107
|
## Shared
|
|
1107
1108
|
- [ ] CONTRACTS.md - no shared types defined yet
|
|
@@ -1138,7 +1139,7 @@ If a dependency is not met:
|
|
|
1138
1139
|
prompts: '^2.4.2',
|
|
1139
1140
|
},
|
|
1140
1141
|
scripts: {
|
|
1141
|
-
|
|
1142
|
+
agent: 'cd "$(git rev-parse --git-common-dir)/.." && node .workflow/agent.js',
|
|
1142
1143
|
complete: 'cd "$(git rev-parse --git-common-dir)/.." && node .workflow/complete.js',
|
|
1143
1144
|
},
|
|
1144
1145
|
};
|
|
@@ -1215,7 +1216,7 @@ branch=$(git symbolic-ref --short HEAD 2>/dev/null)
|
|
|
1215
1216
|
if [ "$branch" = "main" ]; then
|
|
1216
1217
|
echo ""
|
|
1217
1218
|
echo " ⚠ Direct commits to main are not allowed."
|
|
1218
|
-
echo " Use npm run
|
|
1219
|
+
echo " Use npm run agent to start a task."
|
|
1219
1220
|
echo ""
|
|
1220
1221
|
exit 1
|
|
1221
1222
|
fi
|
|
@@ -1237,7 +1238,7 @@ fi
|
|
|
1237
1238
|
console.log(` ${bold('How do you want to build?')}\n`);
|
|
1238
1239
|
|
|
1239
1240
|
console.log(` ${dim('1.')} ${bold('Multi-Agent Driven Orchestration')}`);
|
|
1240
|
-
console.log(`${dim(' · Every task should start with npm run
|
|
1241
|
+
console.log(`${dim(' · Every task should start with npm run agent')}`);
|
|
1241
1242
|
console.log(`${dim(' · Each agent runs in its own git worktree — an isolated branch')}`);
|
|
1242
1243
|
console.log(`${dim(' and folder that merges back into main via npm run complete')}`);
|
|
1243
1244
|
console.log(`${dim(' · Faster builds and lower token spend than a single long session')}`);
|
|
@@ -1256,7 +1257,7 @@ fi
|
|
|
1256
1257
|
'1': {
|
|
1257
1258
|
label: 'Multi-Agent Driven Orchestration',
|
|
1258
1259
|
full: [
|
|
1259
|
-
'Every task must start with npm run
|
|
1260
|
+
'Every task must start with npm run agent.',
|
|
1260
1261
|
'Agent sessions load only task-relevant context, enabling reliable',
|
|
1261
1262
|
'chaining, predictable behavior, and efficient token usage.',
|
|
1262
1263
|
'',
|
|
@@ -1332,7 +1333,7 @@ fi
|
|
|
1332
1333
|
separator();
|
|
1333
1334
|
console.log(`\n ${bold('How do you want to build?')}\n`);
|
|
1334
1335
|
console.log(` ${dim('1.')} ${bold('Multi-Agent Driven Orchestration')}`);
|
|
1335
|
-
console.log(`${dim(' · Every task should start with npm run
|
|
1336
|
+
console.log(`${dim(' · Every task should start with npm run agent')}`);
|
|
1336
1337
|
console.log(`${dim(' · Each agent runs in its own git worktree — an isolated branch')}`);
|
|
1337
1338
|
console.log(`${dim(' and folder that merges back into main via npm run complete')}`);
|
|
1338
1339
|
console.log(`${dim(' · Faster builds and lower token spend than a single long session')}`);
|
|
@@ -1361,7 +1362,7 @@ fi
|
|
|
1361
1362
|
if (launchConfirm) {
|
|
1362
1363
|
rl.close();
|
|
1363
1364
|
console.log('');
|
|
1364
|
-
const child = spawn('node', [path.join(ROOT, '.workflow', '
|
|
1365
|
+
const child = spawn('node', [path.join(ROOT, '.workflow', 'agent.js')], {
|
|
1365
1366
|
stdio: 'inherit',
|
|
1366
1367
|
cwd: ROOT,
|
|
1367
1368
|
});
|
|
@@ -1372,7 +1373,7 @@ fi
|
|
|
1372
1373
|
|
|
1373
1374
|
console.log('');
|
|
1374
1375
|
console.log(` ${bold('When ready, run:')}`);
|
|
1375
|
-
console.log(` ${cyan('npm run
|
|
1376
|
+
console.log(` ${cyan('npm run agent')}\n`);
|
|
1376
1377
|
separator();
|
|
1377
1378
|
console.log('');
|
|
1378
1379
|
rl.close();
|
package/package.json
CHANGED