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 → Asana and click Connect
  2. Authorize Twill in the Asana OAuth prompt — this gives Twill access to your Asana workspace
Once connected, Twill automatically listens for comments across all projects in your Asana workspace, including any projects created after you connect.

​
Create a Twill task from Asana

Comment twill followed by your request on any Asana task: 
twill Add dark mode support
Twill will post an acknowledgment comment on the Asana task with a link to the created Twill task. 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 comment (owner/repo or a GitHub URL)
  2. Your Asana default repository (if set)
  3. If your workspace has only one accessible repo, Twill uses it automatically
  4. If no repo is found, Twill replies on the Asana task asking you to specify one

​
Default Repository

Workspace admins can set the default repository in Settings → Integrations → Asana. If you include a repo in the comment, it always takes priority.

​
Follow-ups

Comment on the same Asana task and mention twill again to add context or adjust the request. Twill treats it as a follow-up on the existing task for that Asana task.

​
Request a Plan

By default, Twill starts implementing immediately. To request a plan first, include /plan in the triggering comment: 
twill /plan Add dark mode support
See Research & Planning for details on how planning and approval works.

​
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 comment: 
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.3 Codex
  • agent=open-code → GPT 5.3 Codex
twill /plan agent=codex model=gpt-5.3-codex owner/repo: Add pagination to the users list
Agent/model overrides only apply when the comment creates a new task. Follow-ups on the same Asana task don’t change the agent/model.

​
Asana Skill

When working on a task triggered from Asana, the Twill agent has access to an Asana skill that lets it read and update the originating Asana task. The agent can:
  • Read task details and comments for additional context
  • Post progress updates as comments on the Asana task
  • Update task fields (e.g., mark the task as complete)
  • Upload files to the Asana task