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

# Interact with Twill

> How you communicate with Twill across all your tools

You can talk to Twill from the tools you already use. The important part is that follow-ups stay attached to the same thread (issue/PR/ticket/comment thread), so you can iterate without re-explaining context.

## Where you can use Twill

* **GitHub**: issues, pull requests, and review threads
* **Linear**: issues
* **Notion**: comments
* **Slack**: mentions (`@twill`)
* **CLI**: run tasks directly from your terminal
* **Sentry**: error and issue events
* **AWS**: read-only access to cloud resources (logs, infrastructure)
* **Web app**: task creation plus logs, previews, and artifacts

## What you can do from integrations

Different tools support different triggers, but the workflow is consistent: you create a task, answer questions if needed, and Twill opens a PR for review. You can also use **Ask mode** to get answers about your codebase without triggering any code changes.

<CardGroup cols={2}>
  <Card title="CLI" href="/cli" icon="terminal">
    Install Twill CLI and run tasks directly from your terminal.
  </Card>

  <Card
    title="GitHub"
    href="/integrations/github-issues"
    icon={
  <svg
    width="20"
    height="20"
    viewBox="0 0 98 96"
    fill="currentColor"
    xmlns="http://www.w3.org/2000/svg"
    aria-hidden="true"
  >
    <path
      fillRule="evenodd"
      clipRule="evenodd"
      d="M48.854 0C21.839 0 0 22 0 49.217c0 21.756 13.993 40.172 33.405 46.69 2.427.49 3.316-1.059 3.316-2.362 0-1.141-.08-5.052-.08-9.127-13.59 2.934-16.42-5.867-16.42-5.867-2.184-5.704-5.42-7.17-5.42-7.17-4.448-3.015.324-3.015.324-3.015 4.934.326 7.523 5.052 7.523 5.052 4.367 7.496 11.404 5.378 14.235 4.074.404-3.178 1.699-5.378 3.074-6.6-10.839-1.141-22.243-5.378-22.243-24.283 0-5.378 1.94-9.778 5.014-13.2-.485-1.222-2.184-6.275.486-13.038 0 0 4.125-1.304 13.426 5.052a46.97 46.97 0 0 1 12.214-1.63c4.125 0 8.33.571 12.213 1.63 9.302-6.356 13.427-5.052 13.427-5.052 2.67 6.763.97 11.816.485 13.038 3.155 3.422 5.015 7.822 5.015 13.2 0 18.905-11.404 23.06-22.324 24.283 1.78 1.548 3.316 4.481 3.316 9.126 0 6.6-.08 11.897-.08 13.526 0 1.304.89 2.853 3.316 2.364 19.412-6.52 33.405-24.935 33.405-46.691C97.707 22 75.788 0 48.854 0z"
    />
  </svg>
}
  >
    Create tasks from issues, PR comments, and review threads.
  </Card>

  <Card
    title="Slack"
    href="/integrations/slack"
    icon={
<svg
  width="20"
  height="20"
  viewBox="0 0 2447.6 2452.5"
  xmlns="http://www.w3.org/2000/svg"
  aria-hidden="true"
>
  <g clipRule="evenodd" fillRule="evenodd">
    <path
      d="m897.4 0c-135.3.1-244.8 109.9-244.7 245.2-.1 135.3 109.5 245.1 244.8 245.2h244.8v-245.1c.1-135.3-109.5-245.1-244.9-245.3.1 0 .1 0 0 0m0 654h-652.6c-135.3.1-244.9 109.9-244.8 245.2-.2 135.3 109.4 245.1 244.7 245.3h652.7c135.3-.1 244.9-109.9 244.8-245.2.1-135.4-109.5-245.2-244.8-245.3z"
      fill="#36c5f0"
    />
    <path
      d="m2447.6 899.2c.1-135.3-109.5-245.1-244.8-245.2-135.3.1-244.9 109.9-244.8 245.2v245.3h244.8c135.3-.1 244.9-109.9 244.8-245.3zm-652.7 0v-654c.1-135.2-109.4-245-244.7-245.2-135.3.1-244.9 109.9-244.8 245.2v654c-.2 135.3 109.4 245.1 244.7 245.3 135.3-.1 244.9-109.9 244.8-245.3z"
      fill="#2eb67d"
    />
    <path
      d="m1550.1 2452.5c135.3-.1 244.9-109.9 244.8-245.2.1-135.3-109.5-245.1-244.8-245.2h-244.8v245.2c-.1 135.2 109.5 245 244.8 245.2zm0-654.1h652.7c135.3-.1 244.9-109.9 244.8-245.2.2-135.3-109.4-245.1-244.7-245.3h-652.7c-135.3.1-244.9 109.9-244.8 245.2-.1 135.4 109.4 245.2 244.7 245.3z"
      fill="#ecb22e"
    />
    <path
      d="m0 1553.2c-.1 135.3 109.5 245.1 244.8 245.2 135.3-.1 244.9-109.9 244.8-245.2v-245.2h-244.8c-135.3.1-244.9 109.9-244.8 245.2zm652.7 0v654c-.2 135.3 109.4 245.1 244.7 245.3 135.3-.1 244.9-109.9 244.8-245.2v-653.9c.2-135.3-109.4-245.1-244.7-245.3-135.4 0-244.9 109.8-244.8 245.1 0 0 0 .1 0 0"
      fill="#e01e5a"
    />
  </g>
</svg>
}
  >
    Create tasks by mentioning <code>@twill</code> in a channel or thread.
  </Card>

  <Card
    title="Linear"
    href="/integrations/linear-issues"
    icon={
<svg
  width="20"
  height="20"
  viewBox="0 0 98 96"
  fill="#5E6AD2"
  xmlns="http://www.w3.org/2000/svg"
  preserveAspectRatio="xMinYMin meet"
  aria-hidden="true"
>
  <path d="M1.22541 61.5228c-.2225-.9485.90748-1.5459 1.59638-.857L39.3342 97.1782c.6889.6889.0915 1.8189-.857 1.5964C20.0515 94.4522 5.54779 79.9485 1.22541 61.5228ZM.00189135 46.8891c-.01764375.2833.08887215.5599.28957165.7606L52.3503 99.7085c.2007.2007.4773.3075.7606.2896 2.3692-.1476 4.6938-.46 6.9624-.9259.7645-.157 1.0301-1.0963.4782-1.6481L2.57595 39.4485c-.55186-.5519-1.49117-.2863-1.648174.4782-.465915 2.2686-.77832 4.5932-.92588465 6.9624ZM4.21093 29.7054c-.16649.3738-.08169.8106.20765 1.1l64.77602 64.776c.2894.2894.7262.3742 1.1.2077 1.7861-.7956 3.5171-1.6927 5.1855-2.684.5521-.328.6373-1.0867.1832-1.5407L8.43566 24.3367c-.45409-.4541-1.21271-.3689-1.54074.1832-.99132 1.6684-1.88843 3.3994-2.68399 5.1855ZM12.6587 18.074c-.3701-.3701-.393-.9637-.0443-1.3541C21.7795 6.45931 35.1114 0 49.9519 0 77.5927 0 100 22.4073 100 50.0481c0 14.8405-6.4593 28.1724-16.7199 37.3375-.3903.3487-.984.3258-1.3542-.0443L12.6587 18.074Z" />
</svg>
}
  >
    Create tasks by adding the <code>twill</code> label or assigning Twill.
  </Card>

  <Card
    title="Notion"
    href="/integrations/notion"
    icon={
<svg
  width="20"
  height="20"
  viewBox="0 0 59.9 62.6"
  fill="none"
  xmlns="http://www.w3.org/2000/svg"
  aria-hidden="true"
>
  <g>
    <g>
      <path
        fill="none"
        d="M3.8,2.7l34.6-2.6c4.2-0.4,5.3-0.1,8,1.8l11.1,7.8c1.8,1.3,2.4,1.7,2.4,3.2v42.7c0,2.7-1,4.3-4.4,4.5
		l-40.2,2.4c-2.6,0.1-3.8-0.2-5.1-1.9L2.1,50.1c-1.5-2-2.1-3.4-2.1-5.1V7C0,4.8,1,2.9,3.8,2.7L3.8,2.7z M3.8,2.7"
      />
      <path
        fill="currentColor"
        fillRule="evenodd"
        clipRule="evenodd"
        d="M38.4,0.1L3.8,2.7C1,2.9,0,4.8,0,7v38c0,1.7,0.6,3.2,2.1,5.1l8.1,10.6c1.3,1.7,2.6,2.1,5.1,1.9l40.2-2.4
		c3.4-0.2,4.4-1.8,4.4-4.5V12.9c0-1.4-0.5-1.8-2.2-3c-0.1-0.1-0.2-0.1-0.3-0.2L46.4,2C43.8,0,42.7-0.2,38.4,0.1L38.4,0.1z
		 M16.2,12.2c-3.3,0.2-4,0.3-5.9-1.3L5.6,7.2C5.1,6.7,5.3,6.1,6.6,6l33.3-2.4c2.8-0.2,4.2,0.7,5.3,1.6l5.7,4.1
		c0.3,0.1,0.9,0.8,0.1,0.8l-34.4,2.1L16.2,12.2z M12.4,55.3V19c0-1.6,0.5-2.3,1.9-2.4l39.5-2.3c1.3-0.1,1.9,0.7,1.9,2.3v36
		c0,1.6-0.3,2.9-2.4,3l-37.8,2.2C13.4,58,12.4,57.2,12.4,55.3L12.4,55.3z M49.7,21c0.2,1.1,0,2.2-1.1,2.3l-1.8,0.4v26.8
		c-1.6,0.9-3,1.3-4.2,1.3c-1.9,0-2.4-0.6-3.9-2.4L26.7,30.6v18.1l3.8,0.9c0,0,0,2.2-3,2.2l-8.4,0.5c-0.2-0.5,0-1.7,0.8-1.9l2.2-0.6
		v-24l-3-0.3c-0.2-1.1,0.4-2.7,2.1-2.8l9-0.6l12.4,19V24.3l-3.2-0.4c-0.2-1.3,0.7-2.3,1.9-2.4L49.7,21z M49.7,21"
      />
    </g>
  </g>
</svg>
}
  >
    Create tasks from comments and keep the plan/approval in the thread.
  </Card>

  <Card
    title="Sentry"
    href="/integrations/sentry"
    icon={
  <svg
    width="20"
    height="20"
    viewBox="-1 0 66 64"
    fill="currentColor"
    xmlns="http://www.w3.org/2000/svg"
    preserveAspectRatio="xMidYMid meet"
    aria-hidden="true"
  >
    <path d="M38.064 7.214C36.618 4.7 34.4 3.258 32.007 3.258S27.395 4.7 25.95 7.214l-7.632 13.26c1.9 1.066 3.7 2.277 5.417 3.613 9.114 7.135 15.256 17.914 16.234 30.136h-4.793c-.944-10.455-6.148-19.7-13.854-25.944-1.685-1.368-3.487-2.59-5.392-3.656L7 40.163a19.95 19.95 0 0 1 5.179 4.014c2.543 2.748 4.314 6.212 4.986 10.05l-8.01-.004c-.88 0-1.594-.716-1.594-1.598a1.62 1.62 0 0 1 .192-.763l2.022-3.44c-1.49-1.608-3.235-2.97-5.18-4.014l-3.39 5.808C-.25 52.728-.392 55.367.8 57.455s3.55 3.286 6.443 3.286h16.51c.117-1 .184-2.036.184-3.075a26.48 26.48 0 0 0-.23-3.438C22.904 48 19.91 42.432 15.526 38.35l2.5-4.343c5.804 5.033 9.745 12.17 10.626 20.22a31.4 31.4 0 0 1 .194 3.438 31.87 31.87 0 0 1-.153 3.075h17.8c.063-1.018.105-2.04.105-3.075 0-1.157-.054-2.3-.132-3.438C45.46 39.6 38.044 26.714 27 18.396l3.632-6.31c.28-.463.788-.773 1.365-.773a1.59 1.59 0 0 1 1.386.81l22.863 39.74a1.6 1.6 0 0 1 .193.763c0 .884-.714 1.598-1.594 1.598l-3.588.004a49.83 49.83 0 0 1 .133 3.437c0 1.035-.043 2.06-.107 3.075h5.452c2.895 0 5.243-1.196 6.443-3.286s1.06-4.727-.385-7.24z" />
  </svg>
}
  >
    Investigate Sentry error events and propose fixes.
  </Card>
</CardGroup>

<Tip>
  Want a plan first? Use `/plan` in the message/comment that triggers Twill (or
  use Linear's `twill-plan` label). See [Research & Planning](/agent/planning).
</Tip>

<Tip>
  Use `/ask` to ask questions about the codebase without making changes. Twill
  explores the code and answers your question — no PR, no file edits. See
  [Research & Planning](/agent/planning#ask-mode).
</Tip>

<Tip>
  You can optionally override the agent/model for a new task by adding `agent=`
  and/or `model=` to the message/comment that triggers Twill. This only applies
  when creating a new task (not follow-ups in an existing thread).
</Tip>

## What shows up where

* **Plans and questions** are posted back to the thread that triggered the task
* **Implementation** happens in a sandbox environment
* **Pull requests** are created in GitHub with a summary and proof-of-work when available, including logs, screenshots, or videos

## How to follow up

Reply in the same thread and mention `@twill` again. Twill treats it as a continuation of the same task.

Examples of clarifying questions:

<Frame>
  <img src="https://mintcdn.com/twill/rQ7yJu4cUPE4XOdg/images/slack-clarifying-questions.png?fit=max&auto=format&n=rQ7yJu4cUPE4XOdg&q=85&s=e9ef20fb744afd42be76f2b94214376a" alt="Twill asking clarifying questions in Slack" width="1350" height="1334" data-path="images/slack-clarifying-questions.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/twill/kGLDvgTksG_NxLEU/images/twill-ui-clarifying-questions.png?fit=max&auto=format&n=kGLDvgTksG_NxLEU&q=85&s=d59a6bab33f5f52ad7b134ce5a47f4e8" alt="Twill asking clarifying questions in the web app" width="2880" height="1800" data-path="images/twill-ui-clarifying-questions.png" />
</Frame>
