Linear

Loops – Linear Docs

/docs/loops

docs

Words: 2,004
Reading time: 9 min
Last crawled: 2026-08-27
Cited by: 4 of their pages
Language: EN

surface: slide deck

Notes Letter System 7 Laptop Word processor Terminal Vending machine Manuscript Receipt Index cards Blueprint Broadsheet E-reader Spiral notebook Slide deck File window Compare all sixteen →

Opening

—

Loops – Linear Docs1 / 13

Overview⁠

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

Loops – Linear Docs2 / 13

Example loops⁠

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 ↗)⁠)

Loops – Linear Docs3 / 13

Create loops with Linear Agent⁠

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

Loops – Linear Docs4 / 13

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 / 13

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 / 13

Review a loop’s runs⁠

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

Loops – Linear Docs7 / 13

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 / 13

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 Docs9 / 13

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 nam

Loops – Linear Docs10 / 13

Permissions⁠

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

Loops – Linear Docs11 / 13

AI credits⁠

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

Loops – Linear Docs12 / 13

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 Docs13 / 13