LinearLinear integration

From Linear issue to merged code

Connect your Linear workspace and route work to the right Capy projects. Teams can delegate issues, keep context attached, and run tasks with predictable branch defaults.

What you can do

What you can do

Bring issue planning and execution into one workflow.

Delegate from Linear

Delegate from Linear

Start work from Linear and hand issues to Capy without switching tools. Capy uses the issue context to drive execution.

Team to project mapping

Team to project mapping

Map Linear teams to Capy projects so tasks route to the right codebase automatically. Unmapped teams use your default project.

Default branch controls

Default branch controls

Set default branches per repository for Linear-origin runs. Capy uses those base branches when starting work from issues.

Configurable automation

Configurable automation

Choose how Linear-origin tasks behave with org-level controls such as auto start and auto-create PR options.

Getting started

Getting started

Connect once, then route work with simple defaults.

ConnectStep 1

Connect

Go to Settings → Apps → Linear and install the org connection. This links your Linear workspace to your Capy organization.

MapStep 2

Map

Set a default project, then map Linear teams to Capy projects. Team mappings determine where delegated work is created.

RunStep 3

Run

Delegate from Linear and let Capy execute the task. Capy applies your mapping and branch defaults so work lands in the right place.

Capabilities

Capabilities

Linear settings in Capy keep execution predictable across teams.

  • Connect one Linear workspace per Capy organization
  • Use a default Capy project for unmapped Linear teams
  • Map Linear teams to specific Capy projects
  • Configure default branches for Linear-origin runs
  • Control auto start and auto-create PR behavior
  • Use Linear context while working in Capy
Peeking Capy
FAQ

FAQ

Common questions about the Linear integration.

How does Capy choose the project for a Linear issue?+
Capy first checks for a team mapping. If no mapping exists, it uses your configured default project for Linear.
Can I control which branch Linear tasks use?+
Yes. You can set default branches for repositories under your Linear app settings. Those branches are used as base branches for Linear-origin runs.
Do I need to be an admin to connect Linear?+
Yes. Org admins install or reconnect the Linear workspace. Team members can then use the integration with the org settings already in place.
What if tasks are routed to the wrong project?+
Review your team mappings in Settings → Apps → Linear. Unmapped teams always fall back to the default project.

Connect Linear and keep work flowing

Route Linear work to the right projects and run tasks with your existing branch and PR workflow.

Capy Portal