Workspaces

Vibe Kanban uses git worktrees to create isolated workspaces for each task. This enables safe parallel execution and easy management of agent-generated code.

What are Workspaces?

Each task in Vibe Kanban runs in its own workspace - a separate directory that contains a copy of your repository. Workspaces are powered by git worktrees, which allow multiple working directories to share the same git repository.

Benefits of Workspace Isolation

• No Conflicts: Agents can work on different tasks simultaneously without interfering
• Safe Experimentation: Each workspace is independent, so you can safely test changes
• Easy Cleanup: Discard unwanted changes by simply removing the workspace
• Parallel Execution: Run multiple agents in parallel without conflicts

How It Works

When you create a task in Vibe Kanban:

1. A new git worktree is created for the task
2. The agent works in this isolated workspace
3. Changes are made in the workspace, not your main branch
4. You review and merge changes when ready

Managing Workspaces

Viewing Workspaces

You can see all active workspaces in Vibe Kanban's interface. Each workspace shows:

• Associated task
• Current status
• Agent assigned
• Progress information

Cleaning Up Workspaces

When a task completes, you can:

• Merge changes back to your main branch
• Discard changes and remove the workspace
• Keep the workspace for further review

Git Worktrees Explained

Git worktrees allow you to have multiple working directories for a single repository. This is different from cloning, as all worktrees share the same git history and can access the same branches.

Benefits of using worktrees:

• Efficient disk usage (shared git objects)
• Fast workspace creation
• Easy branch management
• Native git feature (no special tools needed)

Best Practices

• Keep workspaces clean by removing completed tasks
• Review workspace status regularly
• Merge or discard changes promptly
• Monitor disk space if running many parallel tasks

Next Steps

• Learn about parallel execution
• Read about git integration
• Explore task management
• Check the Vibe Guide for best practices