Team Runs

Team Runs let you dispatch multiple Agents in parallel to handle different tasks simultaneously, tracking all progress in a single view.

This isn't just "opening multiple sessions." Team Runs are an orchestration mechanism — you define a set of tasks and an allocation strategy, XClaw distributes them to multiple Agent instances, each executes independently, and results are consolidated in a unified view.

A real scenario: you have 10 modules that need refactoring. Instead of manually creating sessions one by one, define a Team Run and dispatch all 10 tasks at once. Each Agent works independently on its own module while you watch every one's real-time progress in the Team Runs panel.

The panel provides live summaries — which tasks are done, which are still running, which hit issues and need your input. This shifts you from managing sessions individually to managing a team of Agents.

Team Runs can be started from preset task templates or fully customized. Presets are especially useful for recurring batch operations.

How to

Find the "Team Runs" entry in the left sidebar (usually below the session list) and click "New Team Run" to start.

You'll need to define a task list — either type them in one by one, or select a preset template. Each task is a natural language description, just like how you'd talk to the Agent. For example, you could create batch tasks like "Write unit tests for the user-service module," "Write unit tests for the auth-service module," and so on.

Once your tasks are defined, click "Start" and XClaw creates independent Agent instances for each task, running them in parallel. The Team Runs panel shows each task's status in real time: in progress, completed, or needs attention.

A task needs your input? The panel highlights it in red — click to jump into the corresponding session. Once all tasks are done, review the aggregated results in the panel.

Run similar batch tasks often? Save the task list as a template and start it with one click next time.