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

# Slack

> Create Twill tasks from Slack messages

## Setup

<Tip>
  Make sure your GitHub App is connected and your connected repos are
  accessible. See the [Quickstart](/quickstart).
</Tip>

1. Go to **Settings → Integrations → Slack** and connect your workspace
2. Invite the Twill bot to channels where you want to create tasks

## Create a Task

Mention `@twill` with your request:

```
@twill Add dark mode support
```

<Frame>
  <img src="https://mintcdn.com/twill/rQ7yJu4cUPE4XOdg/images/slack-thread.png?fit=max&auto=format&n=rQ7yJu4cUPE4XOdg&q=85&s=92b9c9f09e24a1f03abd6eecafbd3141" alt="Twill responding to a Slack mention" width="1843" height="1120" data-path="images/slack-thread.png" />
</Frame>

## Follow-ups

You can reply directly in the Slack thread to refine your request or add more context. Twill will incorporate your feedback and continue working on the task.

## Request a Plan

By default, Twill starts implementing immediately.

To request a plan first, include `/plan` in the **triggering** Slack mention:

```
@twill /plan Add dark mode support
```

## 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 **triggering** Slack mention:

```
@twill agent=claude model=sonnet Add dark mode support
```

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

```
@twill agent=open-code model=google/gemini-3.1-pro-preview Fix the login bug
```

<Note>
  Agent/model overrides only apply when the mention creates a new task.
  Follow-ups in the same Slack thread don’t change the agent/model.
</Note>

## Send screenshots and files

You can attach images and files to:

* the initial `@twill` message, and
* follow-up replies in the same thread.

Twill uses supported attachments as additional context when creating/refining plans and when implementing.

**Supported types**

* Images: `image/png`, `image/jpeg`, `image/gif`, `image/webp`
* Text: `text/plain`, `text/markdown`
* Data: `application/json`, `text/yaml`

**Limits**

* Max file size: 10MB per file
* Max processed per Slack message: 5 files
* Max processed from thread history: 10 files (extras ignored)

Unsupported types and oversized files are ignored.

## Thread Context

When you mention `@twill` inside a thread, Twill will fetch that thread’s messages to use as additional context while creating the task. Twill only reads the specific thread where it was mentioned (not all Slack messages).