Linear integration

Connect Linear so HumanLayer can create tasks from Linear issues, sync issue status, and link HumanLayer artifacts back to the source issue.

Before you start

• You must be an organization admin in HumanLayer.
• You must be able to authorize HumanLayer in the target Linear workspace.
• Your Linear workspace should contain the teams and issues your agents will work from.

Connect Linear

1. Open HumanLayer in the browser.
2. Go to Settings.
3. In Integrations, find Linear.
4. Click Connect Linear.
5. Authorize HumanLayer in Linear and return to HumanLayer.
6. Confirm Linear shows as Connected.

Enable the integration

After Linear is connected, keep Enable Linear Integration turned on to allow users in the organization to create HumanLayer tasks from Linear issues.

Turn it off when you want to keep the OAuth connection but temporarily prevent Linear-driven task creation.

Reconnect or disconnect

• If Linear shows Needs Reconnection, click Reconnect Linear and complete the OAuth flow again.
• To remove the connection, hover the Connected badge and click Disconnect?.

Troubleshooting

• If the OAuth flow fails, verify you are authorizing the correct Linear workspace.
• If users cannot create tasks from Linear issues, confirm the integration is connected and enabled.
• If artifacts are not linked back to Linear, confirm the task was created from a Linear issue and the issue is still accessible.