multi-agent-workbench 0.1.0 → 0.1.4

package/README.md

@@ -8,8 +8,9 @@ Create `tasks.json` in your project:
 
 ```json
 [
-  {"id":"L1","owner":"claude","worktree":"../project-claude","task":"API task","prompt":"Implement the API task and commit it."},
-  {"id":"C1","owner":"codex","worktree":"../project-codex","task":"Frontend task","prompt":"Implement the frontend task and commit it."}
+  {"id":"L1","owner":"claude","command":"claude","worktree":"../project-claude","task":"API task","prompt":"Implement the API task and commit it."},
+  {"id":"C1","owner":"codex","command":"codex","worktree":"../project-codex","task":"Frontend task","prompt":"Implement the frontend task and commit it."},
+  {"id":"A1","owner":"antigravity","command":"agy","worktree":"../project-agy","task":"QA task","prompt":"Audit the current changes, fix only clear issues, and commit them."}
 ]
 ```
 
@@ -17,9 +18,40 @@ Install and run:
 
 ```bash
 npm install -g multi-agent-workbench
+multi-agent-workbench init
+# edit tasks.json for your project
+multi-agent-workbench doctor
 multi-agent-workbench
 # or without installing
+npx multi-agent-workbench init
 npx multi-agent-workbench
 ```
 
 The supervisor reads `tasks.json` from the current project and writes `.agent-workbench/status.json` and `.agent-workbench/supervisor.log`. Review each commit before merging or deploying.
+
+## Use as a Codex skill
+
+Clone the repository into your Codex skills directory:
+
+```bash
+git clone https://github.com/ruhul0/multi-agent-workbench.git \
+  ~/.codex/skills/multi-agent-workbench
+```
+
+Then invoke it in a Codex task with:
+
+```text
+Use $multi-agent-workbench to split this project into micro-tasks, assign frontend work to Codex, backend work to Claude, QA to Antigravity, and report live progress.
+```
+
+The skill instructions are in `multi-agent-workbench/SKILL.md`. The Node.js CLI and the skill are independent: use the skill for planning/orchestration guidance, and use `maw` to launch workers.
+
+## Agent login check
+
+Before assigning work, run:
+
+```bash
+maw doctor
+```
+
+It checks whether `claude`, `codex`, and `agy` are available without printing credentials.

package/bin/maw.mjs

@@ -1,11 +1,43 @@
 #!/usr/bin/env node
 import { spawn } from "node:child_process";
+import { spawnSync } from "node:child_process";
 import process from "node:process";
 import { fileURLToPath } from "node:url";
 import { dirname, resolve } from "node:path";
+import { writeFile } from "node:fs/promises";
 
 const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
 const supervisor = resolve(packageRoot, "multi-agent-workbench/scripts/supervisor.mjs");
+const command = process.argv[2];
+if (command === "--help" || command === "-h") {
+  console.log("multi-agent-workbench — run Claude and Codex tasks in parallel");
+  console.log("\nCommands:\n  maw init    Create a starter tasks.json\n  maw doctor Check agent CLIs and authentication\n  maw         Run the task queue in the current project");
+  process.exit(0);
+}
+if (command === "doctor") {
+  const checks = [
+    ["claude", ["auth", "status"]],
+    ["codex", ["login", "status"]],
+    ["agy", ["--help"]],
+  ];
+  for (const [name, args] of checks) {
+    const result = spawnSync(name, args, { encoding: "utf8", timeout: 10000 });
+    const installed = !result.error;
+    const output = `${result.stdout || ""}${result.stderr || ""}`.replace(/token[^\n]*/gi, "token [redacted]").trim();
+    console.log(`${installed ? "✓" : "✗"} ${name}${installed ? ` — ${output.split("\n")[0] || "available"}` : " — not installed"}`);
+  }
+  process.exit(0);
+}
+if (command === "init") {
+  const target = resolve(process.cwd(), "tasks.json");
+  await writeFile(target, JSON.stringify([
+    { id: "L1", owner: "claude", command: "claude", worktree: "../project-claude", task: "Backend task", prompt: "Implement the backend task and commit it." },
+    { id: "C1", owner: "codex", command: "codex", worktree: "../project-codex", task: "Frontend task", prompt: "Implement the frontend task and commit it." },
+    { id: "A1", owner: "antigravity", command: "agy", worktree: "../project-agy", task: "QA task", prompt: "Audit the current changes, fix only clear issues, and commit them." }
+  ], null, 2) + "\n", { flag: "wx" });
+  console.log(`Created ${target}. Edit it, then run maw.`);
+  process.exit(0);
+}
 const child = spawn(process.execPath, [supervisor, ...process.argv.slice(2)], {
   cwd: process.cwd(),
   stdio: "inherit",

package/multi-agent-workbench/SKILL.md

@@ -16,3 +16,7 @@ Use this skill when a software task benefits from multiple coding-agent CLIs wor
 - Expose current state, task, commit, output, and completed history in a live status file/dashboard.
 
 See `references/task-schema.md` for handoff records and `scripts/supervisor.mjs` for the Node.js supervisor.
+
+## Invocation
+
+Install the skill by cloning this repository to `~/.codex/skills/multi-agent-workbench`, then invoke it explicitly with `$multi-agent-workbench`. Before assigning tasks, run `maw doctor` and stop for any missing or unauthenticated worker. Typical ownership is Codex for frontend, Claude for backend logic, and Antigravity for QA/review, but preserve the user's requested assignment.

package/multi-agent-workbench/scripts/supervisor.mjs

@@ -6,7 +6,20 @@ import process from "node:process";
 const root = process.env.WORKBENCH_ROOT || process.cwd();
 const dir = `${root}/.agent-workbench`;
 await mkdir(dir, { recursive: true });
-const tasks = JSON.parse(await readFile(process.env.WORKBENCH_TASKS || `${root}/tasks.json`, "utf8"));
+const taskPath = process.env.WORKBENCH_TASKS || `${root}/tasks.json`;
+let tasks;
+try {
+  tasks = JSON.parse(await readFile(taskPath, "utf8"));
+} catch (error) {
+  console.error(`No tasks.json found at ${taskPath}. Create a task queue first; see the README example.`);
+  process.exitCode = 2;
+  process.exit();
+}
+if (!Array.isArray(tasks) || tasks.length === 0) {
+  console.error(`No tasks found in ${taskPath}. Add at least one Claude or Codex task.`);
+  process.exitCode = 2;
+  process.exit();
+}
 const statePath = `${dir}/status.json`, logPath = `${dir}/supervisor.log`;
 const state = { agents: {}, history: [], recent: [] };
 const save = () => writeFile(statePath, JSON.stringify({ ...state, updated_at: new Date().toISOString() }, null, 2));
@@ -14,8 +27,9 @@ const log = async (line) => { const s = `[${new Date().toISOString()}] ${line}`;
 function run(cmd, args, cwd) { return new Promise(resolve => { const p = spawn(cmd, args, { cwd, stdio: ["ignore", "pipe", "pipe"] }); let out = ""; p.stdout.on("data", x => { out += x; process.stdout.write(x); }); p.stderr.on("data", x => { out += x; process.stderr.write(x); }); p.on("close", code => resolve({ code: code ?? 1, out })); }); }
 async function execute(task) {
   state.agents[task.owner] = { state: "working", task: task.task, commit: null, output: [] }; await log(`${task.owner} start ${task.id}`);
-  const args = task.owner === "claude" ? ["--model", process.env.CLAUDE_MODEL || "haiku", "--effort", "low", "-p", task.prompt, "--dangerously-skip-permissions"] : ["exec", "-m", process.env.CODEX_MODEL || "gpt-6.1-sol", "-s", "danger-full-access", "--dangerously-bypass-approvals-and-sandbox", task.prompt];
-  const r = await run(task.owner === "claude" ? "claude" : "codex", args, task.worktree);
+  const command = task.command || task.owner;
+  const args = command === "claude" ? ["--model", process.env.CLAUDE_MODEL || "haiku", "--effort", "low", "-p", task.prompt, "--dangerously-skip-permissions"] : command === "agy" || command === "antigravity" ? ["--dangerously-skip-permissions", "--print", task.prompt] : ["exec", "-m", process.env.CODEX_MODEL || "gpt-6.1-sol", "-s", "danger-full-access", "--dangerously-bypass-approvals-and-sandbox", task.prompt];
+  const r = await run(command === "claude" ? "claude" : command === "agy" || command === "antigravity" ? "agy" : "codex", args, task.worktree);
   const commit = (r.out.match(/\b[0-9a-f]{7,40}\b/g) || []).at(-1) || null;
   state.agents[task.owner] = { state: r.code === 0 ? "done" : "blocked", task: task.task, commit, output: r.out.split("\n").slice(-30) };
   state.history = [...state.history, { id: task.id, owner: task.owner, task: task.task, commit, state: state.agents[task.owner].state, output: state.agents[task.owner].output, finished_at: new Date().toISOString() }].slice(-40);

package/package.json

@@ -1,21 +1,36 @@
 {
   "name": "multi-agent-workbench",
-  "version": "0.1.0",
+  "version": "0.1.4",
   "description": "Run multiple coding-agent CLIs in parallel with task queues, isolated worktrees, handoffs, and live status.",
   "type": "module",
   "bin": {
     "multi-agent-workbench": "bin/maw.mjs",
     "maw": "bin/maw.mjs"
   },
-  "files": ["bin", "multi-agent-workbench", "README.md", "LICENSE"],
+  "files": [
+    "bin",
+    "multi-agent-workbench",
+    "README.md",
+    "LICENSE"
+  ],
   "scripts": {
     "start": "node bin/maw.mjs",
     "check": "node --check bin/maw.mjs && node --check multi-agent-workbench/scripts/supervisor.mjs",
     "pack:check": "npm pack --dry-run"
   },
-  "engines": {"node": ">=20"},
+  "engines": {
+    "node": ">=20"
+  },
   "license": "MIT",
-  "repository": {"type": "git", "url": "https://github.com/ruhul0/multi-agent-workbench.git"},
-  "bugs": {"url": "https://github.com/ruhul0/multi-agent-workbench/issues"},
-  "homepage": "https://github.com/ruhul0/multi-agent-workbench#readme"
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ruhul0/multi-agent-workbench.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ruhul0/multi-agent-workbench/issues"
+  },
+  "homepage": "https://github.com/ruhul0/multi-agent-workbench#readme",
+  "dependencies": {
+    "multi-agent-workbench": "github:ruhul0/multi-agent-workbench"
+  }
 }