Skip to main content

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.

​
Setup

Make sure your GitHub App is connected and your connected repos are accessible. See the Quickstart.
  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.
TriggerWhat Happens
Add the twill labelCreates task and starts implementing
Assign the Twill userCreates 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.

​
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
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.