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
- Use with a coding agent shows how to let an agent read and update tasks.
- Configuration explains the config file and the default workspace.
-
Troubleshooting helps
when the shell can’t find
asanaor a login doesn’t work.
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.
Work in Asana
asana task
Create and update tasks
35 commands
asana project
Projects and their members
10 commands
asana section
Sections in a project
6 commands
asana workspace
Workspaces and their users
6 commands
asana user
Users and your own account
3 commands
asana team
Teams in an organization
7 commands
asana tag
Tags and the tasks that have them
6 commands
asana attachment
Files and links on tasks
4 commands
asana custom-field
Custom fields, on paid plans
5 commands
asana goal
Goals and metrics, on paid plans
7 commands
asana portfolio
Portfolios, on paid plans
8 commands