Skip to main content

​
Setup

Make sure your GitHub App is connected and your connected repos are accessible. See the Quickstart.
  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
Twill responding to a Slack mention

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

​
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).