Skip to main content
Connect a cloud workspace to GitHub by installing the Twill GitHub App on the repositories you choose, during workspace creation or from workspace settings. That installation powers the cloud workflows below. Local projects can work without it.

​
Start tasks from issues

Mention @twill in an issue body or comment, or add the twill label. Twill reacts with 👀, works the issue in your cloud environment, and links the resulting PR back.
A GitHub issue where @twill was mentioned and answered
Clarifying questions post back as issue comments, and your replies continue the task. To pick a harness or model, include a /trigger in the text or add a label matching one of your routing configs — for example /ultra. For native planning, open the Twill task and send /plan there; review the plan in that chat. See Commands.

​
Work on any pull request

Mention @twill in a PR conversation or a code-review thread — on any PR, not just Twill’s own. Twill checks out the PR branch and pushes to it. For review feedback: leave @twill comments in unresolved review threads. Twill waits about 2 minutes to batch multiple comments, then addresses all unresolved threads in one pass.

​
PR state and CI fixes

When a linked PR is merged or closed, Twill updates its state in the task. When eligible checks fail on a linked PR, Twill posts a PR comment, reads the logs, and pushes a fix. The limit is three automatic attempts per task, shared across CI failures; the counter expires 24 hours after the latest attempt. Twill skips dispatch while a run is already active.