awesome cli.
Command reference

Asana CLI docs

Install the CLI, log in with an Asana token and read your first project.

1. Install the release

On macOS or Linux, the install script downloads the latest release:

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

You can also build it with Go or download a Windows binary. The install section of the product page has both. Then check that your shell finds the command:

asana version

2. Log in

Create a Personal Access Token at app.asana.com/0/my-apps. Run this command and paste the token when it asks:

asana login

In a script or in CI, set ASANA_TOKEN instead. It overrides the saved login. Keep it in a private environment variable and out of your repository.

3. Read a project

asana workspace list
asana project list --workspace "Company"
asana task list --project "Launch Plan" --json

Use your own workspace and project names. If a name matches more than one project, the CLI lists the matches and stops. Then use the GID with --project-gid or --workspace-gid.

4. Preview a change

asana task update 1234567890123456 \
  --name "Review launch checklist" --dry-run

The CLI prints the request it would send and changes nothing. It can still read from Asana to look up names. Run the command again without --dry-run when you want to make the change.

Where to go next

Command reference

These pages come from the CLI’s generated help for v0.1.2. On your machine, asana <command> --help shows the same text for the version you have installed. The list of all commands shows them all on one page.