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.
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.
One issue, isolated sessions
Work where the problem is already tracked
Linear owns the issue and agent session. Aient owns the investigation thread and proposed code change.
- 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
Follow the investigation
Aient acknowledges the work, shares progress, and returns its result through native Linear Agent Activities.
- 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.
Native agent work
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.
Configure
Connect once, then choose your team
- 1. Sign in to Aient. The connect button resumes here after authentication and starts Linear OAuth.
- 2. Approve the Aient app. A Linear workspace administrator may need to approve the installation.
- 3. Choose 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.
Minimum permissions
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.
Questions
Before you connect
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.