Linear Integration

Prerequisites

• A Linear workspace with admin access
• An Ironwork workspace with owner or admin role

Setup

1. Navigate to Integrations in your Ironwork dashboard.
2. Click Connect on the Linear card.
3. Authorize the OAuth connection. Ironwork will request access to your Linear workspace.
4. Once authorized, Ironwork registers each agent (Refine, Build, Review) as a first-class Linear agent in your workspace. Each agent has its own OAuth app credentials.

After setup, your team can assign or @mention any Ironwork agent directly on Linear issues.

What Ironwork accesses

• Issues — title, description, status, labels, and priority
• Comments — all comments and threaded replies on issues
• Team members — for @mention resolution and assignment
• Labels — for categorization and workflow context
• Attachments — images and file attachments on issues

How agents appear

Ironwork agents appear as first-class agents in your Linear workspace, not as bot users or integrations. This means they use the Linear AgentSession API and appear natively in your issue sidebar. Users can @mention or assign them exactly like they would assign a teammate.

Each agent operates independently with its own Linear OAuth credentials. When Refine posts a comment on an issue, it appears under Refine's name — not a generic "Ironwork" account.

Webhook events

Ironwork listens to Linear webhook events to react in real time. Each agent has its own webhook secret for secure event verification.

• Issue updates — when an issue is assigned to an agent or its status changes
• Comment creation — when a user replies to an agent's question or adds new context
• Agent session events — session lifecycle events from the Linear AgentSession API

Troubleshooting