# Parallel Agents

Parallel Agents let you run up to five Agents at the same time. Each tab operates independently -- start a code review in one, refactor in another, and debug in a third, all running in parallel.

## [How Parallel Agents Work](/content/docs/parallel_agents#how-parallel-agents-work/index.html)

Each tab is an independent Agent with its own messages, tools, and state. Switching tabs does not interrupt any running agent.

```
Tab 1: "Refactor auth module"     [streaming...]
Tab 2: "Write unit tests"         [streaming...]
Tab 3: "Debug API endpoint"       [waiting for input]
Tab 4: "Generate docs"            [completed]
```

All four agents work simultaneously. Results stay isolated -- they never mix between tabs.

## [Creating a New Tab](/content/docs/parallel_agents#creating-a-new-tab/index.html)

### [Click the + Button](/content/docs/parallel_agents#click-the--button/index.html)

Click the **+** button at the end of the tab bar to create a new Agent tab.

### [Start a Agent](/content/docs/parallel_agents#start-a-agent/index.html)

The new tab opens as "New Chat". Type your prompt and send.

### [Tab Title Updates Automatically](/content/docs/parallel_agents#tab-title-updates-automatically/index.html)

As the Parallel Agent responds, the tab title updates to reflect the conversation topic.

You can have up to **5 tabs** open at once. The + button disables when you reach the limit.

### [Tab Actions](/content/docs/parallel_agents#tab-actions/index.html)

| Action       | How                                       |
|--------------|------------------------------------------|
| Switch tab   | Click the tab                            |
| Close tab    | Click **X** on the tab (hover to reveal)|
| New tab      | Click **+** button                       |
| View history  | Click the **clock** icon                |
| Pop out      | Click **...** menu                      |

You cannot close the last remaining tab. At least one conversation must stay open.

## [Running Agents in Parallel](/content/docs/parallel_agents#running-agents-in-parallel/index.html)

### [Independent Streaming](/content/docs/parallel_agents#independent-streaming/index.html)

Each tab streams independently:

- Start a prompt in Tab 1
- Switch to Tab 2 and start another prompt
- Both agents continue working simultaneously
- Green pulse indicators show which tabs are active

## [Use Cases](/content/docs/parallel_agents#use-cases/index.html)

### [Multi-Task Development](/content/docs/parallel_agents#multi-task-development/index.html)

Run different development tasks simultaneously:

```
Tab 1: "Implement user authentication"
Tab 2: "Write tests for the payment module"
Tab 3: "Review the changes in the API layer"
```

### [Compare Approaches](/content/docs/parallel_agents#compare-approaches/index.html)

Ask the same question with different modes:

```
Tab 1: [Agent Mode] "Implement caching for the API"
Tab 2: [Plan Mode]  "Implement caching for the API"
```

Compare the agent's direct implementation with the planner's approach.

### [Research and Implement](/content/docs/parallel_agents#research-and-implement/index.html)

Separate research from coding:

```
Tab 1: "Explain how WebSocket reconnection works"
Tab 2: "Add WebSocket reconnection to our client"
```

Read the explanation in Tab 1 while the agent implements in Tab 2.

### [Monitor Long-Running Tasks](/content/docs/parallel_agents#monitor-long-running-tasks/index.html)

For tasks that take time (browser automation, large refactors):

```
Tab 1: [Running browser tests...]     <- Let it run
Tab 2: "Fix the lint errors in utils"  <- Work on something else
```

## [Limits](/content/docs/parallel_agents#limits/index.html)

| Limit                     | Value                                   |
|--------------------------|-----------------------------------------|
| Maximum open tabs        | 5                                       |
| Minimum open tabs        | 1                                       |
| Concurrent streaming      | All tabs can stream at once            |
| Tab reordering           | Not supported                           |

## [Tips](/content/docs/parallel_agents#tips/index.html)

### [Efficient Parallel Workflows](/content/docs/parallel_agents#efficient-parallel-workflows/index.html)

1. **Start long tasks first** -- Kick off time-consuming work in one tab, then switch
2. **Close finished tabs** -- Free up slots for new conversations
3. **Check green indicators** -- Quickly see which agents are still working

### [When to Use Parallel Agents](/content/docs/parallel_agents#when-to-use-parallel-agents/index.html)

- Tasks that are **independent** of each other
- **Long-running** tasks you want to monitor while doing other work
- **Comparing** different approaches to the same problem
- **Research** in one tab while implementing in another

## [Keyboard Reference](/content/docs/parallel_agents#keyboard-reference/index.html)

| Action                                       | Mac               | Windows         |
|----------------------------------------------|-------------------|-----------------|
| Floating Parallel Agent Sidebar               | **Cmd+Shift+L**   | **Ctrl+Shift+L**|
| Toggle Parallel Agent Sidebar                 | **Cmd+Shift+B**   | **Ctrl+Shift+B**|

There are no dedicated keyboard shortcuts for creating or switching tabs. Use the tab bar directly.