Skip to navigation
Connect

Linear

Start sessions from Linear issues, in AOSplane or right from Linear
View as Markdown

Connect your Linear workspace to browse issues in AOSplane and start a session from any of them. Install the AOSplane agent in Linear too, and your team can hand an issue to AOSplane without leaving Linear.

Owners, Admins and Engineers can connect Linear and manage the rules that pick a project for each issue. Only Owners and Admins install the AOSplane agent in Linear.

Connect Linear

1

Open Linear

Choose PM in the narrow rail on the far left, then Linear under Issues. Or open Settings › Connections and choose Connect next to Linear.
2

Authorize

Choose Connect Linear and approve AOSplane in Linear.
3

Check the result

The top of the page shows your workspace as Connected.

Start a session from an issue

1

Find the issue

On the Issues tab, search by title or key (like ENG-482), or filter by team, state and assignee.
2

Start

Choose Start session on its row, or open the issue and choose Start coding session.
3

Choose where it runs

Pick the Target project and Agent. The request is filled in as “Implement” plus the issue’s key, title, description and link.
4

Send it

Start the session. It’s linked to the issue, and the row shows Open session.
Linear page with the workspace pill, Create issue button and the Routing, Issues and Connection tabs, showing the Issues list
The Linear page

Hand issues to AOSplane from Linear

1

Install the agent

On the Connection tab, under AOSplane agent, choose Install agent and approve it in Linear.
2

Add rules

On the Routing tab, choose Add rule. Pick a Linear team, which issues it covers (Any issue, Have a label or In a Linear project), the project to Start sessions in and an Agent. Choose Save rule.
3

Set a default

Turn on Use as the default on one rule so issues from teams with no rule still start somewhere.
4

Hand off in Linear

In Linear, delegate an issue to AOSplane or mention it. A session starts in the project your rules pick, and AOSplane answers in the issue when each turn finishes.
Routing tab with a table of rules showing the Linear team, the project sessions start in and the agent, plus the Any other team row
Rules on the Routing tab

Good to know

  • Replies in the Linear issue continue the same session.
  • Sessions started from Linear run as the person who installed the agent, so they need a connected GitHub account and an AI account.
  • A handed-off issue is added to the project’s tasks.
  • Check where an issue would go, on the Routing tab, shows which rule an issue matches.
  • Create issue at the top of the page files a new Linear issue. Turn on Hand to AOSplane to start work on it at once.
  • Disconnecting Linear stops AOSplane reading and updating issues. Sessions already linked to issues keep their links.
  • The product manager reads Linear for evidence and can file its brief as a Linear issue.