Linear agent

Investigate production problems from Linear

Bring Aient into an issue by assignment or @mention. Aient investigates with production and source context, reports back in Linear, and opens a GitHub fix PR for human review when code needs to change.

Work where the problem is already tracked

Linear owns the issue and agent session. Aient owns the investigation thread and proposed code change.

  1. 1

    Bring Aient into the issue

    Assign an issue to Aient or mention @Aient in a comment. Linear sends the issue context to a dedicated Aient session thread.

  2. 2

    Follow the investigation

    Aient acknowledges the work, shares progress, and returns its result through native Linear Agent Activities.

  3. 3

    Review the proposed fix

    When the problem needs a code change, Aient opens a GitHub pull request. Your team review and merge it through the workflow you already trust.

Progress that belongs in Linear

Aient acknowledges a new session, reports progress, and posts the terminal response through native Linear Agent Activities. Follow-up prompts return to the exact session that received them.

Ask, follow up, stop

Continue the investigation from the issue. A stop signal ends work for that session before Aient starts another work-producing action.

Keep change control

Aient can prepare the fix and open the pull request. Engineers review and merge through GitHub before any code reaches production.

Connect once, then choose your team

  1. 1Sign in to Aient. The connect button resumes here after authentication and starts Linear OAuth.
  2. 2Approve the Aient app. A Linear workspace administrator may need to approve the installation.
  3. 3Choose a default team. Aient uses it when a detected problem creates a Linear issue.

Already connected?

Older connections can keep creating issues but may lack agent assignment and mention permissions. Reauthorise once to request the current scope set.

Reauthorise Linear

Only the access the workflow needs

Aient requests five Linear OAuth scopes. It does not request Linear's admin scope.

read
Read the issue, workspace, and team context needed for the investigation.
write
Post native agent progress and responses back to the active Linear session.
issues:create
Create a Linear issue from an Aient-detected problem when your routing calls for it.
app:assignable
Make Aient available as an issue assignee.
app:mentionable
Let teammates mention @Aient in Linear.

Before you connect

How do I start Aient from Linear?

Assign an issue to Aient or mention @Aient in an issue comment. Aient acknowledges the request in Linear and carries that agent session in its own Aient investigation thread.

Where does Aient show its work?

Agent-session progress and results appear as native Linear Agent Activities. Ordinary Aient-linked issue conversations continue to use issue comments, so the two interaction modes stay distinct.

Can I stop an investigation from Linear?

Yes. A Linear stop signal tells Aient to disengage from that exact agent session before starting more work, then Aient posts one final confirmation.

Does Aient merge code automatically?

No. When remediation needs a code change, Aient opens a GitHub pull request for your team to review and merge. Your existing repository controls remain in charge.

Why might an existing connection need reauthorisation?

Connections created before Linear agent support may not include assignment and mention permissions. Reauthorise once to grant the current minimum scope set. Aient does not request Linear's admin scope.

Stop firefighting. Start fixing.

Connect your telemetry and GitHub. Aient closes the loop on your next production bug.