> ## Documentation Index
> Fetch the complete documentation index at: https://docs.twill.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Linear

> Create Twill tasks from Linear issues

## Setup

<Tip>
  Make sure your GitHub App is connected and your connected repos are
  accessible. See the [Quickstart](/quickstart).
</Tip>

1. Go to **Settings → Integrations → Linear** and connect your workspace
2. Twill will create a `twill` label and a `twill-plan` label in your Linear workspace

## Create a Task

Add the `twill` label to any issue, or assign the Twill user to the issue. Twill creates a task and starts implementing.

| Trigger               | What Happens                         |
| --------------------- | ------------------------------------ |
| Add the `twill` label | Creates task and starts implementing |
| Assign the Twill user | Creates task and starts implementing |

## Request a Plan

By default, Twill starts implementing immediately.

To request a plan first, add the `twill-plan` label to the issue. Twill will post a plan and wait for approval before implementation.
For the end-to-end planning and approval flow, see [Research & Planning](/agent/planning).

## Pick an Agent / Model (optional)

You can optionally override the agent and/or model for a new task by adding `agent=` and/or `model=` to the issue **description** before Twill is triggered:

```
agent=claude model=sonnet
```

If you specify `agent=` but omit `model=`, Twill uses defaults:

* `agent=claude-code` → Opus
* `agent=codex` → GPT 5.4
* `agent=open-code` → GPT 5.4

<Note>
  Agent/model overrides only apply when Twill creates a new task for the issue.
  Follow-ups in the thread don’t change the agent/model.
</Note>

## Approve the Plan

Twill posts the implementation plan in Linear with an approval link.

<Frame>
  <img src="https://mintcdn.com/twill/4igxLdUxMeVeQl3B/images/linear-example.png?fit=max&auto=format&n=4igxLdUxMeVeQl3B&q=85&s=4e789878e92589dba1065f3f2d584cb2" alt="Twill posting an implementation plan in a Linear issue thread" width="1622" height="1086" data-path="images/linear-example.png" />
</Frame>

**Want changes?** Reply in the thread with feedback—Twill will revise the plan.

**Ready?** Click the **Approve** link in Twill's plan message to start implementation.

## Stop Work

Reply in the thread to tell Twill to stop. Twill cancels current work and confirms.