Linear

Linear supplies project issues to Factory boards. Connect a workspace before selecting projects for personal intake. Each selected project also needs a destination Factory and board under the organization's routing settings.

Platform-backed servers use their Platform connection. Servers with their own OAuth application can use the self-managed configuration.

Connect your workspace

You need a running Factory, a linked target repository, and permission to authorize the intended Linear workspace.

1. Open Settings → Work Intake.
2. Under Linear issues, select Connect Linear.
3. Authorize the intended workspace in Linear and return to Factory.
4. Confirm the connected workspace name and that projects are available.

If the section says Linear isn't configured on the server, the server operator must enable a Platform-backed integration or configure a complete OAuth credential pair.

Select projects and route issues

In Work Intake, enable Sync Linear issues and select the projects you want to follow. Projects are grouped by their Linear teams. These selections are personal. Teammates choose their own.

Under Linear routing, choose the destination Factory and board for each selected project. Routing is an organization setting: each Linear project feeds one board in one Factory. Choose Work for the built-in workflow. Factory imports issues only when the project is selected in your personal intake settings and both destinations are configured.

Setting	Scope	Expected result
Workspace connection	Connected organization/workspace	Lists the workspace's available projects.
Sync and project selection	Personal	You follow active issues from the selected projects.
Linear routing	Organization	Each selected project has a destination Factory with the intended codebase and a selected board.

Route the project to a Factory linked to the repository where its issues should be implemented. Confirm the destination before changing shared routing for teammates.

Verify issue intake

1. Create one active issue in a selected, routed Linear project.
2. Return to the destination Factory's Work board.
3. Match the issue's Linear identifier, title, and source link.
4. Select Investigate and inspect the session's understanding of the issue.

Give synchronization time to run. Planning, implementation, and review then follow the Work workflow. When a linked Linear issue becomes completed or canceled, built-in rules can move its Work card to Done or Canceled. Those state changes are asynchronous.

For connection errors, missing issues, or incorrect routing, see Linear troubleshooting.

Use your own OAuth application

For a self-managed connection, create an application using Linear's OAuth documentation. Register the callback at your public origin plus /auth/linear/callback.

Set both credentials on the Factory Server and restart it:

.env

LINEAR_CLIENT_ID=your-linear-client-id
LINEAR_CLIENT_SECRET=your-linear-client-secret

The generated entry uses this explicit integration when both values are present. Preserve credential encryption and a deployment-stable state signer. Users still complete workspace authorization, intake selection, and routing after the server is configured.