Skip to main content
Before using the GitHub integration, make sure the GitHub App is installed for the repository. 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.2 Codex
  • agent=open-code → GPT 5.2 Codex
@twill /plan agent=codex model=gpt-5.2-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.