agy_spawn_swarm
Dispatch multiple read-only Antigravity research subagents across non-overlapping directory partitions to explore independent subsystems in one turn, then aggregate their markdown reports.
Instructions
Dispatch multiple read-only Antigravity subagents using gemini-3.8-flash-low or gemini-3.8-flash-medium across strictly disjoint directory partitions. SERIALIZATION & ASYNC BUDGET: Tasks run sequentially one after another (one at a time, AGY_MAX_CONCURRENCY = 1) and share the same ~8-minute soft budget ceiling; keep each task prompt bounded or fetch any in-flight task result by job_id via agy_job_result. WHEN TO USE: Exploring multiple independent subsystems or directories in a single turn. DO NOT USE FOR: Single-directory research (use agy_delegate_research), single-file signature extraction (use local_file_scout), or overlapping directory paths (rejected by partition validator). RETURNS: Aggregated markdown report per subagent task (or async job_id handles for tasks still running at soft budget) plus telemetry footer.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"tasks": "<tasks>"
},
"name": "agy_spawn_swarm"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cwd | No | Optional workspace root directory path. | |
| tasks | Yes | Array of subagent tasks with strictly non-overlapping directory globs (dispatched sequentially one after another). | |
| soft_timeout_ms | No | Optional soft budget in milliseconds before returning async job_id handles for any remaining tasks (default 540000 = 540s). |