Installation
Install directly from the Visual Studio Code Marketplace:Alternatively, search for the extension ID in VSCode:
VSCode Marketplace
Install the official Vibe Kanban extension for VSCode
- Open VSCode
- Press
Ctrl+Shift+X
(Windows/Linux) orCmd+Shift+X
(macOS) to open Extensions - Search for
@id:bloop.vibe-kanban
- Click Install
Features
The extension provides an integrated workspace view with three main components:Logs View
- List of task attempts for the current task
- Agent steps performed in each task attempt
Diffs View
- Side-by-side comparison of code changes
- Inline commenting and review capabilities
Processes View
- Monitor running task processes
- Process status indicators (running, completed, failed)
Task Management
- Task Iteration: Continue iterating on the current ongoing task
- Status Updates: Real-time task status synchronization
Usage Workflow
1
Start a task in Vibe Kanban
Navigate to your project’s kanban board and create or select an existing task.
2
Open task in full screen
Click on the task to open its detailed view, then switch to full screen mode for better visibility.
3
Launch IDE integration
Click the “Open in VSCode”, “Open in Cursor”, or “Open in Windsurf” button depending on your preferred IDE.
The button text will reflect your editor choice configured in Vibe Kanban settings.
4
Work in your IDE
Your IDE will open in the task’s dedicated worktree with the extension UI populated with:
- Current task context
- Real-time logs
- Code diffs
- Process monitoring
Troubleshooting
Empty Extension UI
Problem: The extension UI appears empty or shows no task information. Solution: Ensure you’re working within a worktree created by a Vibe Kanban task.The extension can only display task information when VSCode is opened in a directory that corresponds to an active Vibe Kanban task worktree.
- Verify you opened VSCode through the “Open in [IDE]” button from a Vibe Kanban task
- Check that you’re in the correct directory/worktree
- If the issue persists, restart your IDE and try the workflow again
Extension Not Loading
Problem: The Vibe Kanban extension doesn’t appear in your IDE. Solutions:- Verify the extension is installed by searching
@id:bloop.vibe-kanban
in Extensions - Restart your IDE after installation
- Check that you’re using a compatible IDE version
- For Cursor/Windsurf users, ensure you installed from Open VSX Registry
Best Practices
Workflow Optimization: Always start tasks from the Vibe Kanban web interface before opening in your IDE to ensure proper context and worktree setup.
Performance: Close unused IDE windows to reduce resource usage.
Supported IDEs
IDE | Status | Installation Method |
---|---|---|
VSCode | ✅ Fully Supported | VSCode Marketplace |
Cursor | ✅ Fully Supported | Open VSX Registry |
Windsurf | ✅ Fully Supported | Open VSX Registry |
The extension is designed to work with any VSCode-compatible editor. If you’re using a different VSCode fork, try installing from Open VSX Registry using the extension ID
bloop.vibe-kanban
.