Labels

Creating Labels

Go to Settings → Labels → New Label. Each label has:

• A name (e.g. "Engineering", "Q1 Planning")
• A color from the theme palette
• An optional parent label for nesting
• Optional auto-apply rules

Applying Labels

Apply labels to a conversation in three ways:

1. 1.Right-click a conversation in the sidebar → Add Label
2. 2.Open the conversation → click the label icon in the top toolbar → select labels from the dropdown
3. 3.Automatically via auto-apply rules (see below)

A conversation can have multiple labels.

Hierarchical Labels

Labels can be nested up to 3 levels deep. A parent label applied to a conversation does not automatically apply its children, and vice versa — they are independent. But the hierarchy helps you filter: filtering by a parent label can optionally include all descendants.

Auto-apply Rules

Auto-apply rules automatically attach a label to a conversation when the conversation title matches a regex pattern. This is useful for automatically tagging conversations based on what you ask about.

// Auto-apply "Engineering" to any conversation about code
{
  "label": "Engineering",
  "rules": [
    {
      "field": "title",
      "pattern": "\\b(code|debug|fix|refactor|deploy|build|test)\\b",
      "flags": "i"
    }
  ]
}

// Auto-apply "Q1 Planning" to conversations mentioning OKRs
{
  "label": "Q1 Planning",
  "rules": [
    {
      "field": "title",
      "pattern": "\\b(OKR|goal|objective|Q1|quarter)\\b",
      "flags": "i"
    }
  ]
}

Rules are evaluated when a new conversation is created and its title is set (typically after the first AI response generates a title). You can also manually trigger re-evaluation from Settings → Labels → Re-apply Rules.

Filtering by Label

In the sidebar, click a label name to filter the conversation list to that label only. Shift-click to add additional labels (OR filter). Hold ⌘while clicking to use AND filter (conversation must have all selected labels).

Label filters stack with status filters and search queries.

Label Colors

Label colors come from the workspace theme palette. By default, 6 colors are available:

Customize the palette in Themes settings.