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.

Before using the GitHub integration, make sure the GitHub App is installed on every repository you want to use with Twill. See the Quickstart.

​
Trigger a Task from an Issue

Create a task from any GitHub issue:
TriggerWhat Happens
Mention @twill in issue body or commentCreates task and starts implementing
Add a twill labelSame as above
Twill reacts with 👀 to confirm it saw your mention.

​
Request a Plan

By default, Twill starts implementing immediately. To request a plan first, include /plan in the same issue body/comment that triggers Twill: 
@twill /plan Add pagination to the users list
For a full explanation of research, planning, and approval, see Research & Planning.

​
Pick an Agent / Model (optional)

You can optionally override the agent and/or model when creating a new task by adding agent= and/or model= to the same issue body/comment (or PR comment) that triggers Twill: 
@twill agent=claude model=sonnet Add pagination to the users list
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
@twill /plan agent=codex model=gpt-5.3-codex Add pagination to the users list
Agent/model overrides only apply when the mention creates a new task. Mentions on an existing Twill task (same issue/PR) don’t change the agent/model.

​
Approve the Plan

After analyzing your issue, Twill posts a comment with the implementation plan and an approval link.
Twill posting an implementation plan as a GitHub comment
Want changes? Reply to the issue with feedback—Twill will revise the plan. Ready? Click the approval link. Twill implements the changes and opens a PR.

​
Work on Any Pull Request

Mention @twill in any pull request to get help:
LocationWhat Happens
PR conversation commentCreates a task linked to the PR branch, Twill analyzes and responds
Code review threadSame as above (batches multiple mentions)
This works on any PR—not just PRs created by Twill. Twill will:
  1. React with 👀 to confirm
  2. Create a task if one doesn’t exist (using the PR’s branch)
  3. Analyze the PR and address your request

​
Address PR Feedback

Mention @twill in any unresolved code review thread. Twill will:
  1. React with 👀
  2. Wait ~2 minutes to batch multiple comments
  3. Address all unresolved threads mentioning @twill

​
Auto-Complete

When a PR with an associated Twill task is merged, the task automatically moves to Completed.