Parallel Execution

One of Vibe Kanban's key features is the ability to run multiple coding agents in parallel without conflicts. This allows you to maximize productivity by working on multiple tasks simultaneously.

How It Works

Vibe Kanban uses git worktrees to create isolated workspaces for each task. This means:

• Each task runs in its own separate workspace
• Agents never interfere with each other
• You can safely merge changes when tasks complete
• No conflicts between parallel tasks

Creating Parallel Tasks

To run tasks in parallel:

1. Create multiple tasks in Vibe Kanban
2. Assign different agents to each task (or use the same agent)
3. Start all tasks - they will run simultaneously
4. Monitor progress from the unified interface

Best Practices

Task Independence

For best results, ensure tasks are independent of each other. Tasks that modify the same files or have dependencies should be run sequentially.

Resource Management

Running many agents in parallel may consume significant system resources. Monitor your system and adjust the number of parallel tasks based on your machine's capabilities.

Agent Selection

You can use different agents for different tasks, or the same agent for multiple tasks. Choose agents based on the specific requirements of each task.

See supported agents for details.

Monitoring Parallel Tasks

Vibe Kanban provides a unified interface to monitor all running tasks:

• View progress of all tasks simultaneously
• See logs for each task independently
• Pause, resume, or stop individual tasks
• Review and merge tasks as they complete

Learn more about monitoring.

Merging Parallel Results

When tasks complete, you can review and merge changes:

1. Review each task's changes using the built-in diff tool
2. Edit changes if needed
3. Approve and merge changes back to your main branch
4. Handle any merge conflicts that arise

Learn more about code review and git integration.

Use Cases

Feature Development

Break a large feature into smaller, independent tasks and run them in parallel. For example, you might have separate tasks for UI components, API endpoints, and tests.

Bug Fixes

Fix multiple unrelated bugs simultaneously by assigning each to a different agent.

Refactoring

Refactor different parts of your codebase in parallel, ensuring each task focuses on a specific area.

Limitations

• Tasks that modify the same files may create merge conflicts
• System resources limit the number of parallel tasks
• Some agents may have rate limits from their providers

Next Steps

• Learn about workspaces and git worktrees
• Read the Vibe Guide for best practices
• Explore supported agents
• Check out full documentation