Skip to main content

# Task Groups & Variants

Task groups let you run the same task with multiple AI agents in parallel, comparing their approaches and selecting the best result.

## What is a Task Group?​

A task group is a collection of related tasks that share:

- Same instructions and context
- Same branch selections for repositories
- Linked visibility in the UI (see all variants together)

Each task in the group is a variant—a different agent's approach to the same problem.

## Creating a Task Group​

Groups are created automatically when you submit a task with multiple agents selected. Select Claude, Codex, Gemini, Bob, and Grok, and you get five variants running in parallel.

You can also add variants to an existing task later (see below).

## Parallel Execution​

When your server has multiple queue slots available, variants run simultaneously:

1. All selected agents start at roughly the same time
2. Each works independently in its own container
3. Results become available as each agent finishes
4. You can review completed variants while others are still running

This parallel approach means you get multiple solutions in about the same time it takes to get one.

## Viewing Variants​

In the task detail view:

- All variants appear as tabs or panels
- Each variant shows its own activity feed
- Switch between variants to see progress, logs, and changes
- Status indicators show which are running, completed, or failed

## Comparing Variants​

Click the comparison view (trophy icon) to see variants side-by-side:

- Code changes: Diffs from each agent
- Summaries: What each agent reported doing
- Exit status: Success or failure
- Files modified: Count and list of changes

This view helps you quickly assess which approach looks best before diving into details.

## Adding Agents to Existing Groups​

You can add more variants to a completed task:

1. Open the task detail
2. Click the Resubmit icon
3. Select additional agent(s)
4. Ensure "Add as variant to existing group" is checked
5. New variants are created and grouped with the original

This is useful when you want another agent's perspective after seeing initial results, or when you want to try a different agent on a task that didn't produce satisfactory results.

## When to Use Task Groups​

Task groups are most valuable when:

- Uncertain requirements: Different agents may interpret ambiguous instructions differently
- Complex problems: Multiple approaches might all be valid
- Learning agent strengths: Compare how Claude, Codex, Gemini, Bob, and Grok handle your codebase
- High-stakes changes: Get multiple opinions before committing

For simple, well-defined tasks, a single agent is often sufficient. Use groups when the extra perspectives are worth the compute time.