Skip to content

Linear ​

Monitors selected Linear issues and reports assignment or tracked-state transitions through the Linear GraphQL API.

Pollen Types ​

TypeDescription
linear_issue_newA newly selected issue was created inside the overlap window
issue_assignedThe issue became assigned to assignee_id
issue_updatedStatus, priority, or assignee changed

Setup ​

Create a personal API key in Linear's API settings and export it:

bash
export LINEAR_API_KEY="lin_api_..."
/hive hire linear

Configuration ​

json
{
  "linear": {
    "enabled": true,
    "api_key_env": "LINEAR_API_KEY",
    "team_id": "",
    "assignee_id": "",
    "max_items": 50,
    "max_pages": 10,
    "overlap_minutes": 5
  }
}
FieldDefaultDescription
api_key_envLINEAR_API_KEYAPI-key environment variable
team_id""Optional exact team ID filter
assignee_id""Optional exact assignee ID filter/classifier
max_items50Cursor page size, from 1 to 250
max_pages10Cursor page cap, from 1 to 10
overlap_minutes5Updated-time overlap, from 0 to 1,440 minutes

The adapter sends filters as GraphQL variables, validates cursor progress, and preserves state when pagination cannot reach a safe end.

Released under the Apache 2.0 + Commons Clause License.