awesome cli.

Read Asana tasks as JSON from the terminal

List Asana tasks as JSON, save them to a file and inspect them with jq. Use project names or IDs with the unofficial Asana CLI.

Run asana task list --project "Launch Plan" --json to read a project’s tasks as JSON. Replace "Launch Plan" with your project’s name. You can save the result to a file or pass it to another command.

The unofficial Asana CLI reads the data your Asana account can access. You need a Personal Access Token to log in.

The examples use v0.1.2. Follow the installation and login documentation first. Awesome CLI’s maintainer also maintains this CLI.

List tasks from a project

First find the workspace and project you want to read:

asana workspace list
asana project list --workspace "Company"

Then list the project’s tasks as JSON:

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

These workspace and project names are examples. If more than one project has the same name, use the project’s Asana GID, the identifier Asana assigns to it:

asana task list --project-gid 1234567890123456 --json

The --json option prints output that scripts and other programs can read. To save the result and inspect it with jq, a command-line tool for reading and processing JSON, run:

asana task list --project "Launch Plan" --json > tasks.json
jq . tasks.json

To read the results immediately, run the task-list command without redirecting output. To use them in a script or another program, save the JSON to a file or pipe it to the program.

What this command reads

Task listing reads a project’s tasks. It does not use Asana’s premium task-search endpoint. The account’s permissions still apply; the CLI cannot read a private project your token cannot access.

See the task command reference for filters such as assignee, section and limit. The examples here use v0.1.2. The public README is the source for installation and authentication.