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

# Asana

> Create Twill tasks from Asana comments

## 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 → 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](/agent/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
```

<Note>
  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.
</Note>

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