Task Labels

Task labels are color-coded tags you apply to tasks for additional categorization beyond task groups and states. Use them to mark priority levels, project phases, team ownership, or any classification that helps your team find and filter work.

Creating Labels

Labels are managed at the workspace level from any task group:

1. Navigate to a task group
2. Open the label management panel
3. Click New Label
4. Enter a name (e.g., "High Priority", "Backend", "Q2 Goal")
5. Choose a color (hex color picker)
6. Click Create

Labels are workspace-scoped — a label created in one task group is available in all task groups.

Applying Labels to Tasks

From the Task View

Open a task and click the labels area to add or remove labels. You can apply multiple labels to a single task.

From Chat

Ask an agent to manage labels:

@Assistant add the "high-priority" label to the API migration task

@Assistant label all open tasks in the Engineering group as "Q2 Goal"

Agent Tools

Agents have two dedicated label tools:
- add_task_label — Apply a label to a task
- remove_task_label — Remove a label from a task
- list_task_labels — View all available labels

Filtering by Label

In the task group list view, use the filter controls to show only tasks with specific labels. This is useful for:

• Viewing all "bug" tasks across a project
• Finding tasks tagged with a specific sprint or milestone
• Isolating tasks by team (e.g., "frontend", "backend", "design")

Editing and Deleting Labels

From the label management panel:

• Edit — Change a label's name or color
• Delete — Remove a label entirely (it's removed from all tasks that had it)

The management view shows a usage count for each label, so you can see how widely it's used before deleting.

Label Strategies

By Priority

• Critical (red) — Must be done immediately
• High (orange) — Important, do this week
• Normal (blue) — Standard priority
• Low (gray) — Do when time allows

By Type

• Bug (red) — Something is broken
• Feature (green) — New functionality
• Improvement (blue) — Enhancement to existing feature
• Chore (gray) — Maintenance or cleanup

By Team

• Frontend (purple)
• Backend (blue)
• Design (pink)
• DevOps (orange)

Tips

• Keep labels workspace-wide — Don't recreate the same label in different groups; they're shared across all task groups
• Use colors meaningfully — Consistent color coding (red = urgent, green = ready) makes labels scannable at a glance
• Combine with states — Labels complement task states. A task can be "In Progress" (state) and "High Priority" + "Backend" (labels)
• Let agents manage labels — Agents can add and remove labels, which is especially useful in trigger skills (e.g., auto-label tasks from webhooks)