Loops – Linear Docs

—

Loops let Linear drive work forward automatically. They can trigger on a scheduled cadence, or when issues match a set of conditions. Consider creating loops for repeatable tasks, like: - When an issue enters this team’s

Here are some basic loops that are useful for most workspaces. Create custom loops for your team by prompting Linear, or get started with one of these examples. Investigate and delegate bug reports (Build this loop ↗)⁠)

The best way to create loops is to first achieve the outcome you want in a Linear Agent chat, then continue to refine it into a loop. For example, you might be the lead of a project that has check-in meetings each Thursd

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

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

Each loop has a run history to let you audit its behavior. Open Loops from the workspace or team that contains the loop Open the loop you want to review Select Run history Review recent runs to see when the loop executed

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

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

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 nam

Loops support a range of permissions to control what they can access and do. Enable only the permissions your loop needs to fulfill its intended purpose, and consider the impact of each one before enabling it. Team acces

Starting July 20, Loops will require AI credits to run. AI credits are purchased and managed by workspace admins in Settings. To help your team get started, we’re giving Business and Enterprise workspaces $20 per seat in

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