Linear

Connect Factory to Linear so Droid can reference Linear project context during development workflows.

Prerequisites

• Admin access to your Linear workspace
• A Factory account with the Manager or Owner role

Integration steps

1. 1
   Access Factory Integrations

   Log in to your Factory account and navigate to the Integrations section in your Settings.

2. 2
   Initiate Linear Integration

   Locate and select the Linear integration option.

3. 3
   Authorize Factory's Linear Application

   You'll be redirected to Linear. Review the requested permissions and click "Authorize" to allow Factory access to your Linear workspace.

4. 4
   Configure Team and Project Access

   Select the teams and projects you want Factory to interact with. You can adjust these settings later if needed.

5. 5
   Set Up Permissions

   Ensure that Factory has the necessary permissions to view and create issues, manage workflows, and access relevant project data.

6. 6
   Confirm Integration

   After granting permissions, you'll be redirected back to Factory. Verify that the integration status shows as "Connected".

7. 7
   Create a New Session

   Create a new session directly from Linear with this ticket in context by clicking the Open in Factory link on the Factory attachment that appears on the issue.

   • Note that clicking this link will always create a new session.

Verification

To ensure the integration is working correctly:

1. 1
   Create a test issue in one of the authorized Linear projects.
2. 2
   Use Factory to interact with this issue (e.g., comment on it or change its status).
3. 3
   Verify that the changes are reflected in Linear.

Best practices

• Regularly review and audit the permissions granted to Factory.
• Use Linear's team-level settings to manage access efficiently.
• Keep your Linear workspace's security settings up-to-date.

Troubleshooting