{"id":"pg_1ajd7rnl9mfm","property_id":"prp_xmyp1ziwpl3m","domain_id":"dom_cmnflwxgauzb","root_domain":"linear.app","locale":"en","url":"https://linear.app/docs/agents-in-linear","url_hash":"6a409600401ddd338aba0547291f7a7ee66f79c15e349ec68459f98902233fb9","path":"/docs/agents-in-linear","depth":1,"canonical_url":"https://linear.app/docs/agents-in-linear","canonical_page_id":null,"page_type":"docs","page_type_guess":"docs","state":"indexed","skip_reason":null,"priority":"1.4","discovered_via":"sitemap","first_seen_at":"2026-08-27T09:04:29.608Z","last_seen_at":"2026-08-27T09:04:44.198Z","http_status":200,"content_hash":"67cca5c0d5b612bc092d4ad17e79b11256fcb96de5a972d8d4b5e9194f12c356","title":"AI Agents – Linear Docs","description":"Build and deploy AI agents that work alongside your team","author":null,"published_at":null,"modified_at":null,"word_count":754,"reading_time_sec":206,"lang_detected":"en","images":[],"links_out":null,"markdown_source":"readability","refresh_interval":"monthly","last_fetched_at":"2026-08-27T09:04:36.389Z","next_refresh_at":"2026-09-26T09:04:36.389Z","runs_count":1,"changes_count":0,"last_changed_at":null,"fail_count":0,"last_error":null,"created_at":"2026-08-27T09:04:29.608Z","updated_at":"2026-08-27T09:04:29.608Z","inlinks":2,"inlinks_body":2,"outlinks":38,"outlinks_external":0,"anchor_terms":["AI Agents"],"template_score":"0.13333333333333333333","cash":"0.008187134502923977","cash_total":"0.108187134502923977","pagerank":null,"is_orphan":false,"link_confirmed":true,"discovered_wave":0,"embedded_hash":"67cca5c0d5b612bc092d4ad17e79b11256fcb96de5a972d8d4b5e9194f12c356","embedded_at":"2026-08-27T09:13:31.418Z","domain_name":"Linear","brand_color":null,"domain_rank":449,"spam_score":14,"markdown":"Build and deploy AI agents that work alongside your team\n\n![list of agents in assignee menu, Charlie and ChatPRD are visible](https://webassets.linear.app/images/ornj730p/production/68c955d01e0e45b23747e8cd7362b018b06a6655-2880x1768.png?w=1440&q=95&auto=format&dpr=2)\n\n## Overview[⁠](#overview)\n\nAgents, also known as “app users”, behave similar to other users in a workspace. Depending on the permissions granted during installation, agents can be mentioned, delegated issues through assignment, create and reply to comments, and collaborate on projects and documents. App users are installed and managed by workspace admins.\n\nAgents are not traditional assignees. Assigning an issue to an agent delegates the issue to that agent while the human teammate remains the primary assignee and owner — explore [Assign and delegate issues](https://linear.app/docs/assigning-issues) to learn more.\n\n## Adding Agents[⁠](#adding-agents)\n\nWorkspace admins can install agents by following the setup instructions provided by the agent developer. Find available agents in the [Integrations Directory](https://linear.app/integrations/agents).\n\nDuring installation, you’ll be prompted to choose which teams the agent has access to.\n\n![Installing the codegen agent into Linear permissions modal](https://webassets.linear.app/images/ornj730p/production/9a11b2deb2fd1f6b5649f00ebaa928124f061099-1292x1019.png?w=1440&q=95&auto=format&dpr=2)\n*Example of installing an agent into Linear*\n\nOnce installed, any user with access to the selected teams can interact with the agent. Admins can also review agent access from the [AI & Agents](https://linear.app/settings/ai) settings in the _Installed Agents_ section.\n\n## Using Agents in Linear[⁠](#using-agents-in-linear)\n\nAgents are designed to work seamlessly alongside human teammates:\n\n-   **Delegate issues to them** by assigning the issue to the agent. This triggers the agent to take action based on its programmed behavior.\n    -   The human assignee remains responsible for the issue, even after delegation to an agent.\n-   **@mention them** in comments or descriptions to trigger their functions.\n\nIf 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.\n\n## Guiding Agents[⁠](#guiding-agents)\n\nAgent guidance lets you provide instructions that agents will automatically receive when they work on issues in your workspace.\n\n![Screenshot of the Additional guidance panel showing repository instructions for agents](https://webassets.linear.app/images/ornj730p/production/d9cb1836286c78822dddee0e6e9ec3c67a1c10a9-1570x788.png?w=1440&q=95&auto=format&dpr=2)\n\nAgent 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.\n\n**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.\n\nWorkspace 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.\n\nGuidance is authored in a markdown editor with full history, so instructions can be formatted clearly and reviewed or updated over time.\n\nTo edit your workspace-level agent guidance, navigate to [_Settings_ > _Agents_ > _Additional guidance_](https://linear.app/settings/agents). For team-level guidance, navigate into your parent or sub-team’s settings > _Agents_ > _Additional guidance_. Both workspace and team level guidance may not exist in all agent contexts.\n\n## Viewing Agent Activity[⁠](#viewing-agent-activity)\n\nYou can track what an agent has done in the same ways you track other teammates:\n\n-   **Agent** [**user pages**](https://linear.app/docs/user-views) show issue activity and contributions.\n-   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.\n-   **Custom views** filtered by **Delegate** to monitor agent involvement on specific types of issues or workflows.\n-   Use **Insights** sliced or segmented by **Delegate** to measure how much work is being directed to and handled by agents.\n\n## Building Your Own Agent[⁠](#building-your-own-agent)\n\nDevelopers can build custom agents using Linear’s developer platform. Documentation on agent APIs, authentication, and behavior can be found in our [Developer Docs](https://linear.app/developers/agents).\n\n## FAQs[⁠](#faqs)\n\nAgents 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.\n\nLinear does not train on customer’s data. We use models from common model providers, a complete list is available in our [DPA](https://linear.app/dpa).\n\nAgents 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.\n\nAgents cannot sign in to the app, access admin functionality or manage users.\n\nIn the event that you have a member on your workspace with the same name as an Agent, the Agent’s username will simply append a number at the end to keep it unique.\n\nFor example, Charlie would become Charlie1.\n\n## [⁠](#)","storage":{"htmlKey":"stealpage/html/linear.app/pg_1ajd7rnl9mfm/run_l9g96uvmknhq.html.gz","markdownKey":"stealpage/md/linear.app/pg_1ajd7rnl9mfm/run_l9g96uvmknhq.md.gz"},"facets":{"page_id":"pg_1ajd7rnl9mfm","domain_id":"dom_cmnflwxgauzb","root_domain":"linear.app","locale":"en","format":"research","depth":2,"technicality":2,"promotional":2,"originality":2,"audience":"developer","funnel_stage":"awareness","intent":"informational","evidence":"none","tone":"plain","has_code":false,"code_langs":[],"has_data":false,"has_tables":false,"has_images":false,"has_video":false,"has_faq":false,"external_links":10,"heading_count":8,"topics":["software development","project management","ai"],"keywords":["AI agents","Linear","workspace admins","agent guidance","custom agents"],"entities":{},"takeaways":["AI agents in Linear function as app users that can be assigned issues and interact with team members, but they don't replace human assignees.","Workspace admins can install and manage agents through the Integrations Directory, with options to control team access and agent guidance.","Agent guidance allows teams to provide instructions that help agents align with specific workflows and conventions, though the interpretation depends on the agent integration."],"summary":"This document explains how to use and manage AI agents within the Linear platform to enhance team collaboration and workflow automation.","ai_likelihood":"0.087","shelf_life":"evergreen","quality_score":"0.4913","fingerprint":"67cca5c0d5b612bc092d4ad17e79b11256fcb96de5a972d8d4b5e9194f12c356","model":"qwen/qwen3-30b-a3b","classified_at":"2026-08-27T09:11:05.162Z","created_at":"2026-08-27T09:11:05.162Z","updated_at":"2026-08-27T09:11:05.162Z"},"assets":[{"kind":"image","src_url":"https://linear.app/api/og/docs?title=AI+Agents","r2_key":null,"alt":null,"caption":null,"width":null,"height":null,"is_hero":true,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/1da47a1cbf8563070d25e5794910b622f03a428d-16x16.svg?auto=format&dpr=2&q=95","r2_key":null,"alt":"Linear Agent","caption":null,"width":16,"height":16,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/0ba9c78fdd4e19b308e1b9bdb530743e3090e397-16x16.svg?auto=format&dpr=2&q=95","r2_key":null,"alt":"Loops","caption":null,"width":16,"height":16,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/5914e5199f95b48d50cdd2eb6cb02e0a8d6e7a24-16x16.svg?auto=format&dpr=2&q=95","r2_key":null,"alt":"AI Agents","caption":null,"width":16,"height":16,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/2cdac5693b0de3e76857d0348f18de4be8caa0fb-15x15.svg?auto=format&dpr=2&q=95","r2_key":null,"alt":"Assign and delegate issues","caption":null,"width":15,"height":15,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/2308492a72303e9c95f13dad1591c985c13c0c0a-16x16.svg?auto=format&dpr=2&q=95","r2_key":null,"alt":"Triage Intelligence","caption":null,"width":16,"height":16,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/6c9a57ffb812e20c93862d04b62ae5ee5893358e-16x16.svg?auto=format&dpr=2&q=95","r2_key":null,"alt":"Code Intelligence","caption":null,"width":16,"height":16,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/29c4b34fb60291548806810a8ecb3145c7fc736a-16x16.svg?auto=format&dpr=2&q=95","r2_key":null,"alt":"Coding sessions","caption":null,"width":16,"height":16,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/6b6af6cd841b626b6949c15c3393d726b85d51db-16x16.svg?auto=format&dpr=2&q=95","r2_key":null,"alt":"MCP server","caption":null,"width":16,"height":16,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/9b68e0a012db8709a0b436cf9f3e9667e318ae9d-16x16.svg?auto=format&dpr=2&q=95","r2_key":null,"alt":"Integration Directory","caption":null,"width":16,"height":16,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/2343b6069438cf3dce5dcc32d77deda57c678905-16x16.svg?auto=format&dpr=2&q=95","r2_key":null,"alt":"MCP server","caption":null,"width":16,"height":16,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/19e75836df171dd43193bf2d3daf6faada748596-16x16.svg?auto=format&dpr=2&q=95","r2_key":null,"alt":"AI Agents","caption":null,"width":16,"height":16,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/37fa8000e5f87ed22f21256bbbe026370ae93c16-16x16.svg?auto=format&dpr=2&q=95","r2_key":null,"alt":"Airbyte","caption":null,"width":16,"height":16,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/f804eb9398d8f30985150f15604b8c225e477217-16x16.svg?auto=format&dpr=2&q=95","r2_key":null,"alt":"Linear Asks","caption":null,"width":16,"height":16,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/c6475146f9bc5a1499c0211e734e36025dc7f974-16x16.svg?auto=format&dpr=2&q=95","r2_key":null,"alt":"Discord","caption":null,"width":16,"height":16,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/39805ebc1087ba353c212f48ca3b2e7810670c7f-16x16.svg?auto=format&dpr=2&q=95","r2_key":null,"alt":"Figma","caption":null,"width":16,"height":16,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/3e98d5afaf83119d0934475d6e4168abce295eb4-16x16.svg?auto=format&dpr=2&q=95","r2_key":null,"alt":"Front","caption":null,"width":16,"height":16,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/281c20337377c02a254eed2aaa191c0dfcf0cb8f-16x16.svg?auto=format&dpr=2&q=95","r2_key":null,"alt":"GitHub","caption":null,"width":16,"height":16,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/52b23c9d3b77865a403059dbaea9b187f5edb24a-16x16.svg?auto=format&dpr=2&q=95","r2_key":null,"alt":"GitLab","caption":null,"width":16,"height":16,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/9b42494e63e94c3a36ea50357abb89eac48de4b6-16x16.svg?auto=format&dpr=2&q=95","r2_key":null,"alt":"Google Sheets","caption":null,"width":16,"height":16,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/8d8ad9d8e3ff9cb949c365ff2a56e91670b06d7d-16x16.svg?auto=format&dpr=2&q=95","r2_key":null,"alt":"Gong","caption":null,"width":16,"height":16,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/6043dcf4ee20fb820fa71f17f9d9c99fb38a6244-16x16.svg?auto=format&dpr=2&q=95","r2_key":null,"alt":"Intercom","caption":null,"width":16,"height":16,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/b4ed29b2721bb179949f9f22d0a90b775eda1d73-16x16.svg?auto=format&dpr=2&q=95","r2_key":null,"alt":"Jira","caption":null,"width":16,"height":16,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/9ad8a23671491d788b8da7afceec1ae7278f9d68-16x16.png?auto=format&dpr=2&q=95","r2_key":null,"alt":"Microsoft Teams","caption":null,"width":16,"height":16,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/3f74f298541c9330cef4ff4e9e4d881f04a6cac6-16x16.svg?auto=format&dpr=2&q=95","r2_key":null,"alt":"Notion","caption":null,"width":16,"height":16,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/25efb8b0008d88966f8892be5965b1eb1ea5b646-16x16.svg?auto=format&dpr=2&q=95","r2_key":null,"alt":"Salesforce","caption":null,"width":16,"height":16,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/61f628718b18e99cc4b65c9e9197727813646fff-16x16.svg?auto=format&dpr=2&q=95","r2_key":null,"alt":"Sentry","caption":null,"width":16,"height":16,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/b72b74457ec6124a93ae825b3e10e40ce4dfd314-16x16.svg?auto=format&dpr=2&q=95","r2_key":null,"alt":"Slack","caption":null,"width":16,"height":16,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/641f65d05b4ad72de980b71a52d92f20c672f7e9-16x16.svg?auto=format&dpr=2&q=95","r2_key":null,"alt":"Zapier","caption":null,"width":16,"height":16,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/bdb234238f4691a632ddf95d34953d3691d1ec23-16x16.svg?auto=format&dpr=2&q=95","r2_key":null,"alt":"Zendesk","caption":null,"width":16,"height":16,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/68c955d01e0e45b23747e8cd7362b018b06a6655-2880x1768.png?auto=format&dpr=2&q=95&w=1440","r2_key":null,"alt":"list of agents in assignee menu, Charlie and ChatPRD are visible","caption":null,"width":1440,"height":1768,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/9a11b2deb2fd1f6b5649f00ebaa928124f061099-1292x1019.png?auto=format&dpr=2&q=95&w=1440","r2_key":null,"alt":"Installing the codegen agent into Linear permissions modal","caption":"Example of installing an agent into Linear","width":1440,"height":1019,"is_hero":false,"zone":"main"},{"kind":"image","src_url":"https://webassets.linear.app/images/ornj730p/production/d9cb1836286c78822dddee0e6e9ec3c67a1c10a9-1570x788.png?auto=format&dpr=2&q=95&w=1440","r2_key":null,"alt":"Screenshot of the Additional guidance panel showing repository instructions for agents","caption":null,"width":1440,"height":788,"is_hero":false,"zone":"main"}],"shots":[],"history":[{"id":"run_l9g96uvmknhq","started_at":"2026-08-27T09:04:36.307Z","http_status":200,"fetcher":"direct","changed":false,"diff":null,"word_count":754}],"citedBy":[{"id":"pg_xkiva8_zgfae","url":"https://linear.app/docs/mcp","title":"MCP server – Linear Docs","anchors":["AI Agents"],"zone":"main"},{"id":"pg_jkfmau7pfq2b","url":"https://linear.app/docs/loops","title":"Loops – Linear Docs","anchors":["AI Agents"],"zone":"main"}]}