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 → 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 reacts to the triggering comment so you can see it picked up the request, then posts an acknowledgment comment on the Asana task with a link to the created Twill task.

​
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, and reacts to the follow-up comment as confirmation that it picked it up.

​
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.4
  • agent=open-code → GPT 5.4
twill /plan agent=codex model=gpt-5.3-codex 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