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

# GitHub

> Turn issues into PRs, iterate on review feedback, and let Twill fix CI — all from GitHub.

Connect a cloud workspace to GitHub by installing the Twill GitHub App on the repositories you choose, during [workspace creation](https://docs.twill.ai/environment.md#two-ways-to-set-up) or from workspace settings. That installation powers the cloud workflows below. [Local projects](https://docs.twill.ai/local-execution.md) 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](https://docs.twill.ai/environment.md), and links the resulting PR back.

![A GitHub issue where @twill was mentioned and answered](https://mintcdn.com/twill/4igxLdUxMeVeQl3B/images/github-example.png?fit=max\&auto=format\&n=4igxLdUxMeVeQl3B\&q=85\&s=0c71d3bd016474a35536a5bc5d9b5a4f)

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](https://docs.twill.ai/agent-config/routing.md) — for example `/ultra`. For native planning, open the Twill task and send `/plan` there; review the plan in that chat. See [Commands](https://docs.twill.ai/tasks.md#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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.