AI Agents
Build and deploy AI agents that work alongside your team
Overview
Agents, also known as "app users", behave similar to other users in a workspace. They can be @-mentioned, delegated issues through assignment, create and reply to comments, collaborate on projects and documents, etc. App users are installed and managed by workspace admins.
Agents are not traditional assignees. Assigning an issue to an agent triggers delegation—the agent acts on the issue, but the human teammate remains responsible for its completion.
Adding Agents
Workspace admins can install agents by following the setup instructions provided by the agent developer. Find available agents in the Integrations Directory.
During installation, you’ll be prompted to choose which teams the agent has access to.
Once installed, any user with access to the selected teams can interact with the agent.
Agents can be uninstalled or managed by admins from Settings > Applications or suspended from Settings > Administration > Members.
Using Agents in Linear
Agents are designed to work seamlessly alongside human teammates:
- Delegate issues to them by assigning the issue to the agent. This triggers the agent to take action based on its programmed behavior.
- The human assignee remains responsible for the issue, even after delegation to an agent.
- @mention them in comments or descriptions to trigger their functions.
If you're not sure how to interact or what they're able to help with, you can try @mentioning the agent to ask for help.
Guiding Agents
Agent guidance lets you provide instructions that agents will automatically receive when they work on issues in your workspace.
Agent guidance provides instructions that help agents work within your team’s conventions. Guidance can specify which repository to use for certain code changes, how to reference issues in commits or pull requests, and what review process to follow, so agents align with your existing workflows.
Note: All guidance is passed to the agent, but how it is interpreted or applied depends on the specific agent integration. If an agent doesn’t appear to follow the guidance, please share feedback with the team responsible for that agent directly.
Workspace guidance applies across the entire organization, while team-specific guidance can be used to include additional instructions unique to that team. When both exist, team guidance takes priority.
Guidance is authored in a markdown editor with full history, so instructions can be formatted clearly and reviewed or updated over time.
To edit your workspace-level agent guidance, navigate to Settings > Agents > Additional guidance. For team-level guidance, navigate into your parent or sub-team's settings > Agents > Additional guidance.
Viewing Agent Activity
You can track what an agent has done in the same ways you track other teammates:
- Agent user pages show issue activity and contributions.
- In the My issues view, issues that you’ve delegated to agents will still appear—so you maintain visibility and control over the work in progress.
- Custom views filtered by Delegate to monitor agent involvement on specific types of issues or workflows.
- Use Insights sliced or segmented by Delegate to measure how much work is being directed to and handled by agents.
Building Your Own Agent
Developers can build custom agents using Linear’s developer platform. Documentation on agent APIs, authentication, and behavior can be found in our Developer Docs.
FAQs
Agents are not counted as billable seats in Linear. The services that provide the agent may have their own pricing structure, and you should refer to their documentation before installing.
Linear does not train on customer's data. We use models from common model providers, a complete list is available in our DPA.
Agents themselves would be 3rd party integrations approved by your workspace, in which case we can't speak to how the agent provider operates and you'd have to refer to the agent service provider.