Linear Connections
Linear connections let agents read and write issues, comments, projects, and users in a Linear workspace. Authentication uses Linear’s OAuth flow with actor=app, so agent activity appears in Linear under the Firetiger app identity rather than impersonating a real user.
Installation
- Navigate to Integrations in the Firetiger UI
- Click New Connection
- Select Linear as the connection type
- Click Install Linear App
- In the Linear authorization screen, select your workspace and click Allow
The connection is created automatically with your organization details. The OAuth refresh token is stored as a secret and renewed transparently.
What Gets Stored
| Field | Source |
|---|---|
organization_id |
Linear API |
organization_name |
Linear API |
access_token |
OAuth (refreshed automatically) |
refresh_token |
OAuth |
scopes |
OAuth grant |
Tools
| Tool | Description |
|---|---|
linear_create_issue |
Create a new issue |
linear_update_issue |
Update an existing issue (status, assignee, labels, etc.) |
linear_get_issue |
Fetch a single issue by ID or identifier (e.g., ENG-123) |
linear_list_issues |
List/search issues with filters |
linear_list_issue_statuses |
List workflow states for a team |
linear_list_issue_labels |
List labels |
linear_list_projects |
List projects |
linear_list_users |
List workspace members |
linear_list_comments |
List comments on an issue |
linear_create_comment |
Post a comment on an issue |
Agents typically call linear_list_issue_statuses and linear_list_issue_labels once at the start of a workflow to resolve names to IDs before creating or updating issues.
Description Field
Document which teams and projects agents should target, and the conventions for issue creation:
Engineering Linear workspace.
Teams:
- ENG: backend services (default for production incident issues)
- WEB: frontend (default for UI bugs)
Conventions:
- Production incidents → team=ENG, label="incident", state="Triage"
- Bugs from monitoring → label="auto-detected", priority=2
- Always link the originating investigation URL in the description
Re-authorization
To refresh permissions or reconnect a workspace:
- Navigate to Integrations
- Find your Linear connection
- Delete and recreate the connection — Linear OAuth scopes are not additive
Best Practices
- One workspace per connection — separate connections for separate Linear orgs avoids agents posting issues to the wrong place
- Document the default team/project in the description so agents don’t have to guess
- Use labels to mark agent-generated issues so you can audit and filter agent activity in Linear