User flow
- In your Linear workspace, create a new issue or use an existing one
- The title and description are used to create a prompt, and should cover the user scenario that needs to be tested
- Attachments are also supported: e.g., images in the issue are provided to the agent
- Assign the issue to the Empirical agent
- This creates a request in Empirical
- A link to the request is posted as a comment on the Linear issue
- Empirical AI agents start working on the request right away
- Once the request is completed, the integration posts a status update back on the issue
Routing to projects
If your organization has one project, all Linear issues are routed to it. With multiple projects, map each Linear team to a project under Settings → Requests → Project associations. Issues are then routed by their team.Get started
To install the Linear integration:Permissions
The integration requests the following permissions:| Scope | Purpose |
|---|---|
| Create webhooks | Create a webhook that receives Linear events when the agent is assigned an issue |
| Read issues | Get the contents of the issue, including title, description, and attachments |
| Write comments | Post comments with request links and status updates |
| Read user | Get details of the user who assigned the issue |