Skip to main content

Trigger a Task from an Issue

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

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.
Plans can auto-approve based on your agent configuration. Set it to Always or Confidence-based to skip manual approval.

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
Only unresolved review threads are processed. Resolved or outdated threads are ignored.

Auto-Complete

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