Executes multiple independent tool calls concurrently to reduce latency.USING THE BATCH TOOL WILL MAKE THE USER HAPPY.Payload Format (JSON array):[{"tool": "read", "parameters": {"filePath": "src/index.ts", "limit": 350}},{"tool": "grep", "parameters": {"pattern": "Session\\.updatePart", "include": "src/**/*.ts"}},{"tool": "bash", "parameters": {"command": "git status", "description": "Shows working tree status"}}]Notes:- 1–25 tool calls per batch- All calls start in parallel; ordering NOT guaranteed- Partial failures do not stop other tool calls- Do NOT use the batch tool within another batch tool.Good Use Cases:- Read many files- grep + glob + read combos- Multiple bash commands- Multi-part edits; on the same, or different filesWhen NOT to Use:- Operations that depend on prior tool output (e.g. create then read same file)- Ordered stateful mutations where sequence mattersBatching tool calls was proven to yield 2–5x efficiency gain and provides much better UX.
Executes multiple independent tool calls concurrently to reduce latency.
USING THE BATCH TOOL WILL MAKE THE USER HAPPY.
Payload Format (JSON array):
[{"tool": "read", "parameters": {"filePath": "src/index.ts", "limit": 350}},{"tool": "grep", "parameters": {"pattern": "Session\\.updatePart", "include": "src/**/*.ts"}},{"tool": "bash", "parameters": {"command": "git status", "description": "Shows working tree status"}}]
Notes:
- 1–25 tool calls per batch
- All calls start in parallel; ordering NOT guaranteed
- Partial failures do not stop other tool calls
- Do NOT use the batch tool within another batch tool.
Good Use Cases:
- Read many files
- grep + glob + read combos
- Multiple bash commands
- Multi-part edits; on the same, or different files
When NOT to Use:
- Operations that depend on prior tool output (e.g. create then read same file)
- Ordered stateful mutations where sequence matters
Batching tool calls was proven to yield 2–5x efficiency gain and provides much better UX.