Skip to main content
Task creation interface showing Add Task button and form fields
After creating a project, add tasks by clicking the plus (+) icon in the top right of your project kanban page, or by using the keyboard shortcut c. You have two options when creating a task:
  • Create Task: Adds the task to your kanban board without starting a coding agent
  • Create & Start: Creates the task and immediately starts it with your default coding agent and current branch

​
Using Task Tags

Task tag autocomplete dropdown showing available tags after typing @ symbol
When adding a task, you can insert reusable text snippets using task tags:
  1. Type @ in the task description or follow-up message
  2. Start typing the tag name to filter available tags
  3. Select a tag from the dropdown to insert its content
Task tags save time by providing reusable text snippets for common task structures. Learn more in the Task Tags guide.

​
Starting an Existing Task

Task attempt creation dialog showing agent profile and variant selection options
When you open a task that hasn’t been attempted yet, you’ll see the task title, description, and a list of attempts showing “no attempts yet”. Click the plus (+) button to create a task attempt and configure:
  • Agent profile: Choose from available agents (e.g., CLAUDE_CODE, GEMINI, CODEX). Your default configuration from Settings is pre-selected.
  • Variant: If your selected agent has variants, pick the appropriate one (e.g., DEFAULT, PLAN).
  • Base branch: Specify which branch the agent should work from. Your current branch is selected by default.
Use Create & Start to add the task and immediately create a task attempt with your default settings in one action.
To monitor your task as it executes, see Monitoring Task Execution. To understand when you might need multiple attempts, see New Task Attempts.

​
Creating Tasks via MCP Clients

This is not the typical method for creating tasks but can be valuable for bulk task creation, migrating from other systems, using an AI assistant with extra project context, or for coding agents that want to create new tasks.
Tasks can also be created programmatically using coding agents or MCP (Model Context Protocol) clients such as Claude Desktop or Raycast. This approach is particularly useful for:
  • Bulk task creation based on existing data or project specifications
  • Migration from other systems like Linear, GitHub Issues, or Jira
  • Automated task generation from project plans or requirements documents
For detailed setup instructions and examples, see the Vibe Kanban MCP Server documentation.

​
Example MCP Task Creation

Once configured with an MCP client, you can create multiple tasks from a project description: 
I need to implement user authentication with:
- Email/password registration
- Login with session management  
- Password reset functionality
- Email verification
- Protected route middleware

Please create individual tasks for each component.
The MCP client will automatically generate structured tasks in your Vibe Kanban project based on this description.

​
Understanding Task Columns

Tasks begin in the “To do” column and move automatically based on their progress:
ActionColumn
Task createdTo do
Task attempt startedIn Progress
Task attempt completed (success or failure)In Review
Task attempt mergedDone
PR merged on GitHubDone
You can manually drag tasks between columns, but this won’t trigger any functionality. Task movement is primarily driven by coding agent actions and GitHub integration (which polls every 60 seconds).