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

> Trigger Twill tasks from GitHub issues and pull requests.

<Tip>
  Before using the GitHub integration, make sure the GitHub App is installed on
  every repository you want to use with Twill. See the
  [Quickstart](/quickstart).
</Tip>

## Trigger a Task from an Issue

Create a task from any GitHub issue:

| Trigger                                   | What Happens                         |
| ----------------------------------------- | ------------------------------------ |
| Mention `@twill` in issue body or comment | Creates task and starts implementing |
| Add a `twill` label                       | Same 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](/agent/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
```

<Note>
  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.
</Note>

## Approve the Plan

After analyzing your issue, Twill posts a comment with the implementation plan and an approval link.

<Frame>
  <img src="https://mintcdn.com/twill/4igxLdUxMeVeQl3B/images/github-example.png?fit=max&auto=format&n=4igxLdUxMeVeQl3B&q=85&s=0c71d3bd016474a35536a5bc5d9b5a4f" alt="Twill posting an implementation plan as a GitHub comment" width="1878" height="1604" data-path="images/github-example.png" />
</Frame>

**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:

| Location                | What Happens                                                        |
| ----------------------- | ------------------------------------------------------------------- |
| PR conversation comment | Creates a task linked to the PR branch, Twill analyzes and responds |
| Code review thread      | Same 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**.