awesome cli.

Open source MIT v0.1.2

Asana CLI

Asana CLI is an unofficial command-line tool for Asana. Use it to read and change your tasks and projects from the terminal. Scripts and coding agents can run the same commands.

Free. Runs on Linux, macOS and Windows.

bash
$ asana task list --project "Launch Plan"
GID               NAME                     COMPLETED
1209876543210101  Write release notes      false
1209876543210102  Review launch checklist  false
1209876543210103  Update pricing page      true

$ asana task update 1209876543210102 \
    --name "Review launch copy" --dry-run
DRY RUN: would PUT /tasks/1209876543210102
  body:
    name = Review launch copy
  no changes were made
Output from v0.1.2. The project and tasks are example data.

What you can do with it

There is a command group for each part of Asana. Each command has examples in --help and in the command reference.

Tasks

Create and update tasks, then mark them done. You can also comment on a task or move it to another section.

asana task create "Write release notes" \
  --project "Launch Plan"
asana task move 1234567890123456 -s "Done"
Reference

Projects and sections

List the projects in a workspace or duplicate one. Sections have their own commands.

asana project list --workspace "Company"
asana section list -p "Launch Plan"
Reference

Users and teams

Check which account you are logged in with and look up the people in a workspace.

asana user me
asana team list -w "Company"
Reference

Tags and attachments

Create tags and list the tasks that have one. You can attach a file or a link to a task.

asana tag list -w "Company"
asana attachment upload report.pdf \
  --task 1234567890123456
Reference

Custom fields and goals

Create custom fields and keep goals up to date. Both need a paid Asana plan.

asana custom-field list -w "Company"
asana goal list -w "Company"
Reference

Portfolios

Create portfolios and add projects to them. Portfolios also need a paid Asana plan.

asana portfolio list -w "Company"
asana portfolio project add 1234567890123456 \
  --project-gid 9876543210987654
Reference

What does the output look like?

By default you get a table. Add --json and you get stable JSON that a script or an agent can parse.

You can also filter the JSON with --jq or render it with a Go template. --plain prints unstyled lines with tabs between the columns.

If a project name matches more than one project, the CLI stops and asks for the GID.

$ asana task list --project "Launch Plan"
GID               NAME                     COMPLETED
1209876543210101  Write release notes      false
1209876543210102  Review launch checklist  false
1209876543210103  Update pricing page      true
$ asana task list --project "Launch Plan" --json
[
  {
    "assignee": {
      "gid": "1201",
      "name": "Sam Lee"
    },
    "completed": false,
    "due_on": "2026-11-03",
    "gid": "1209876543210101",
    "name": "Write release notes",
    "section": {
      "gid": "1209876543210201",
      "name": "This week"
    }
  },
  {
    "assignee": null,
    "completed": false,
    "due_on": "2026-11-05",
    "gid": "1209876543210102",
    "name": "Review launch checklist",
    "section": {
      "gid": "1209876543210201",
      "name": "This week"
    }
  },
  {
    "assignee": {
      "gid": "1202",
      "name": "Ana Ruiz"
    },
    "completed": true,
    "due_on": null,
    "gid": "1209876543210103",
    "name": "Update pricing page",
    "section": {
      "gid": "1209876543210202",
      "name": "Done"
    }
  }
]
$ asana task list --project "Launch Plan" \
  --jq '.[] | select(.completed == false) | .name'
"Write release notes"
"Review launch checklist"
$ asana task list --project "Launch Plan" --plain
1209876543210101	Write release notes	false
1209876543210102	Review launch checklist	false
1209876543210103	Update pricing page	true

Output from v0.1.2. The project and tasks are example data.

What happens before a change?

Commands that change Asana take --dry-run. The CLI then prints the request it would send and changes nothing in Asana. It can still read from Asana during a dry run, for example to look up a project by name.

Delete and remove commands stop with an error unless you add --confirm.

$ asana task update 1209876543210102 \
    --name "Review launch copy" --dry-run --json
{
  "dry_run": true,
  "method": "PUT",
  "path": "/tasks/1209876543210102",
  "body": {
    "name": "Review launch copy"
  }
}
$ asana task delete 1209876543210102
Error: destructive action requires --confirm

Install Asana CLI

Release binaries are on GitHub for Linux, macOS and Windows, each on amd64 and arm64.

macOS and Linux

This script downloads the latest release and checks its checksum. Read the script before you run it.

curl -fsSL https://raw.githubusercontent.com/vincentsch/asana-cli/main/install.sh | bash

Go

Build v0.1.2 from source with Go 1.22.2 or newer.

go install github.com/vincentsch/asana-cli/cmd/[email protected]

Windows

Download asana-windows-amd64.exe or asana-windows-arm64.exe from the latest release. Rename it to asana.exe and put it in a folder on your PATH.

Latest release ↗

Use it with a coding agent

A coding agent with shell access can run the same commands. Ask it to read the project first and to show you the --dry-run output before it changes a task.

The prompt is only an instruction. Your token decides what the agent can reach in Asana.

Set it up for an agent
Example prompt
Read the Launch Plan project. Tell me which task you plan to change. Show the task GID and the update command with --dry-run. Wait for me to approve the change.

Guides for Asana CLI

Questions

Is this an official Asana tool?

No. Asana CLI is an open-source project by Vincent Schmalbach, who also runs this directory. Asana, Inc. does not make or endorse it.

What can it see in my Asana account?

It sees what your token sees. A Personal Access Token belongs to your Asana user, so the CLI has the same access you have. Don’t paste the token into a prompt or commit it to a repository.

Do I need a paid Asana plan?

Some commands work with Asana features that need a paid plan:

  • task search, which uses Asana’s premium search API
  • custom fields
  • goals and portfolios

To read the tasks in a project, use asana task list. It does not use the search API.

Is it stable?

It is at version 0.1.2, so there is no 1.0 yet. Command names and JSON output are meant to stay the same, but they can still change before 1.0.

How do I update it?

Run asana update --check to see if there is a new release. asana update installs it after checking the release checksums. On Windows, download the new binary from the release page.

Where do I report a bug?

Open an issue on GitHub and add the output of asana version and the command you ran. Remove your token and private data first.