@tangle-network/sandbox-cli 0.13.0-develop.20260727080351.3333e68 → 0.13.0-develop.20260727092139.956d833

package/README.md

@@ -92,6 +92,7 @@ Top-level command groups:
 - `usage`
 - `permissions`
 - `backend`
+- `batch`
 - `process`
 - `fs`
 
@@ -189,6 +190,34 @@ tangle sandbox create --name gpu-eval \
 The final detach output includes billed seconds and customer cost.
 Use `tangle usage` to inspect account-level GPU seconds and GPU spend.
 
+## Batch Runs
+
+Run each task against one explicitly named backend:
+
+```bash
+tangle batch run --tasks tasks.json --backend primary=opencode
+```
+
+`tasks.json` is an array of `{ "id": "...", "message": "..." }` objects or an object with a `tasks` array.
+At least one `--backend <id=type>` is required with `--tasks` or `--task`.
+
+Repeat `--backend <id=type>` to run every task against multiple backends:
+
+```bash
+tangle batch run --tasks tasks.json \
+  --backend writer=opencode \
+  --backend reviewer=claude-code \
+  --stream
+```
+
+Backend IDs must be unique and use 1 to 128 letters, numbers, dots, underscores, or hyphens.
+Use `--model provider/model` only when one backend is selected.
+Each result is identified by both `taskId` and `backendId`.
+JSON output reports `totalTasks`, `totalBackends`, `totalExecutions`, `totalSuccess`, `totalFailure`, `totalRetries`, and `successRate`.
+
+Use `--request <file.json>` when each backend needs its own model, profile, server, or lifecycle configuration.
+The file uses the same complete request shape as the TypeScript SDK and cannot be combined with inline task or backend flags.
+
 ## Provisioning Coverage
 
 `tangle sandbox create` supports environments or container images, resources, temporary GPU leases, lifecycle limits, driver and backend selection, SSH and web terminal, environment variables, secrets, metadata, git clone, BYOS3 storage, and snapshot restore.

package/SKILL.md

@@ -305,6 +305,7 @@ tangle tools install <id> python 3.12
 
 # Batch tasks across sandboxes
 tangle batch run --tasks tasks.json
+tangle batch run --tasks tasks.json --backend writer=opencode --backend reviewer=claude-code --stream
 
 # Intelligence reports
 tangle intelligence sandbox <id>
@@ -340,7 +341,8 @@ tangle permissions add <sandboxId> --userId <userId> --role editor
 | Save and restore state | `tangle snapshot create <id>` → ...work... → `tangle snapshot revert <id> <snap-id>` |
 | Set secret for agent use | `tangle secret create GITHUB_TOKEN "..."` → agent reads via `process.env.GITHUB_TOKEN` |
 | Set hub permissions | `tangle hub permissions set --connection conn_xxx --action github.issues.createIssue --decision allow` |
-| Batch parallel agent prompts | `tangle batch run --tasks tasks.json` (array of `{sandboxId, message}`) |
+| Batch parallel agent prompts | `tangle batch run --tasks tasks.json --backend primary=opencode` (array of `{id, message}`) |
+| Compare backends on the same tasks | `tangle batch run --tasks tasks.json --backend writer=opencode --backend reviewer=claude-code --stream` |
 
 ## Common Mistakes