Labels

Tag sessions with colored labels for organization and filtering. Labels support hierarchical nesting, typed values, and auto-apply rules that extract data from messages using regex patterns.

What are Labels?

Labels help you organize and categorize your sessions. Unlike statuses (which represent workflow state), labels are flexible tags you can apply to sessions for any purpose.

Features

Colors

Choose from a palette of colors for visual distinction

Hierarchy

Nest labels under parent labels for organization

Typed Values

Labels can have values (text, number, date)

Auto-Apply Rules

Automatically apply labels based on message content

Creating Labels

  1. Click Labels in the sidebar
  2. Right-click and select Add New Label
  3. Enter a name and choose a color
  4. Optionally set a parent label for nesting

Applying Labels

You can apply labels to sessions in several ways:

  • Click the label icon in the session header
  • Drag a session to a label in the sidebar
  • Use the keyboard shortcut L

Auto-Apply Rules

Auto-apply rules let you automatically label sessions based on message content. This is useful for categorizing sessions by project, topic, or other criteria.

{
  "id": "project-alpha",
  "label": "Project Alpha",
  "color": "#3b82f6",
  "autoApply": {
    "pattern": "(?i)project\s*alpha|#alpha",
    "extractValue": false
  }
}

Typed Values

Labels can extract and store values from messages:

{
  "id": "priority",
  "label": "Priority",
  "valueType": "number",
  "autoApply": {
    "pattern": "priority:\s*(\d+)",
    "extractValue": true
  }
}

This would extract "3" from a message containing "priority: 3"