Skip to main content

​
Setup

Make sure your GitHub App is connected and the repo is 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
If you don’t include a repo in your message, Twill will pick one for you. For the full repository selection rules, see below.
Twill responding to a Slack mention with repo selection
Know the repo? Include it directly: 
@twill owner/repo: Add pagination to the users list

@twill https://github.com/owner/repo: Fix the login bug

​
How Twill Picks a Repository

Twill chooses a repository in this order:
  1. A repo specified in your message (owner/repo or a GitHub URL)
  2. If you mention @twill inside a thread, the most recent repo mentioned earlier in that same thread
  3. Your workspace Default repository (Slack) setting (if set)
  4. If no repo is found, Twill will:
    • auto-select your only connected repo (if there’s just one), or
    • ask you to choose from a dropdown
    • if you have no connected/accessible repos, ask you to connect GitHub or specify owner/repo

​
Default Repository

Workspace admins can set a Default repository (Slack) in Settings → Integrations → Slack. When set, @twill do something will create tasks in that repo without prompting you to pick one. If you include a repo in the message, it overrides the default. If the default repo is invalid or not accessible to Twill’s GitHub installation, Twill will reply with an error and ask you to update the setting (or reinstall the GitHub app for that repo).

​
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.2 Codex
  • agent=open-code → GPT 5.2 Codex
@twill /plan agent=codex model=gpt-5.2-codex owner/repo: Add pagination to the users list

@twill agent=open-code model=google/gemini-3-flash-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).