Opening
—
Loops – Linear Docs1 / 14
- Words
- 2,557
- Reading time
- 12 min
- Last crawled
- 2026-09-26
- Cited by
- 6 of their pages
- Language
- EN
Overview
Available on paid plans. Loops that use Linear Agent draw from your workspace’s AI credits. Loops let Linear drive work forward automatically. They can run on a set schedule or when supported triggering events occur on i
Loops – Linear Docs2 / 14
Example loops
Consider creating loops for repeatable tasks, like: - When an issue enters a team’s triage queue, use Code Intelligence to investigate its likely root cause. If a fix is possible, start a coding session. - Every Friday a
Loops – Linear Docs3 / 14
Create loops with Linear Agent
The best approach is to first achieve the outcome you want in a Linear Agent chat, then refine it into a loop. For example, you might be leading a project that has check-in meetings every Thursday morning. You’re about t
Loops – Linear Docs4 / 14
Create loops manually
You can also create a new loop directly in the interface. In your sidebar, click Loops under the workspace group to start a new workspace-level loop. To create a new team loop, click the team name in your sidebar, then c
Loops – Linear Docs5 / 14
Update loops
Prompt Linear to update an existing loop, or make changes directly in the interface: Open the list of Loops Select the loop you want to update Click Edit Update the loop fields as needed. These changes are saved as a dra
Loops – Linear Docs6 / 14
Review a loop’s runs
Each loop has a run history to let you audit its behavior. Open a loop’s Run history to ask Linear Agent follow-up questions or request additional actions using the run’s context. Open Loops from the workspace or team th
Loops – Linear Docs7 / 14
Restoring a previous version
All published versions of a loop are saved and can be restored. Please note that removed connectors cannot be restored as they need to be authenticated again manually. Start editing a loop as usual Click on Published ver
Loops – Linear Docs8 / 14
Use Slack with Loops
Connect a Loop to your workspace’s Slack integration to let it work in Slack as Linear. A Loop can use one connected Slack workspace. You must link your Slack account to Linear and be a full member of the workspace to co
Loops – Linear Docs9 / 14
MCP Connectors
MCP connectors extend what Linear Agent can do during a loop run. When a connected MCP is available to a loop, Linear can use it to gather context or take supported actions in other services. For example: - Search or ret
Loops – Linear Docs10 / 14
Setup
Workspace owners can manage who can create and manage workspace loops in Settings → Security → Workspace management → Manage loops - Team owners can control who can create and manage loops in Settings → Teams → Team name
Loops – Linear Docs11 / 14
Permissions
Loops support a range of permissions to control what they can access and do. Enable only the permissions your loop needs to fulfil its intended purpose, and consider the impact of each one before enabling it. Team access
Loops – Linear Docs12 / 14
AI credits
Loops use AI credits, which workspace admins can purchase and manage in Settings. Purchased credits expire 12 months after the purchase date. If a workspace runs out of credits, Loops pause unless an admin purchases more
Loops – Linear Docs13 / 14
FAQ
Clearly describe the intended outcome and any actions Linear Agent should avoid. For example: Investigate the issue using the available context. Add a comment summarizing the likely cause and recommend the next action. D
Loops – Linear Docs14 / 14
