Skip to main content

​
Setup

Make sure your GitHub App is connected and the repo is accessible. See the Quickstart.
  1. Go to Settings → Integrations → Linear and connect your workspace
  2. Twill will create a Twill label group, a label owner/repo for each repository you have connected, and a twill-plan label

​
Create a Task

Add a repository label to any issue. Twill auto-assigns itself and creates a task.
TriggerWhat Happens
Add a repo: owner/repo labelCreates 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 (in the Twill label group). Twill will post a plan and wait for approval before implementation. For the end-to-end planning and approval flow, see Research & 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.2 Codex
  • agent=open-code → GPT 5.2 Codex
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.

​
Approve the Plan

Twill posts the implementation plan in Linear with an approval link.
Twill posting an implementation plan in a Linear issue thread
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.