Asana CLI

A command-line interface to manage your Asana tasks and projects directly from your terminal.

Installation

Pre-built binaries

Download the latest binary for your platform from the releases page.

From Source

go install github.com/timwehrle/asana/cmd/asana@latest

Bash Installation

This installation option is experimental, because the OS and architecture get detected automatically.

curl -sSL https://raw.githubusercontent.com/timwehrle/asana/main/scripts/install.sh | bash

Homebrew Installation

brew tap timwehrle/asana
brew install --formula asana

Getting started

Authentication

1. Get your Personal Access Token from Asana (Settings > Apps > Developer Apps)
2. Run the login command:

   asana auth login

3. Follow the prompts to paste your token and select your default workspace.

To check the current status of your authentication and the Asana API:

asana auth status

Configuration

Set or get your default workspace:

asana config set default-workspace
asana config set dw

asana config get default-workspace
asana config get dw

Basic Commands

View your tasks:

asana tasks list # List all your tasks
asana tasks list --sort due-desc # Sort tasks by descending due date
asana tasks view # Interactive task viewer with details
asana tasks update # Interactive task updater

View the projects in your workspace:

asana projects list # List all the projects
asana projects list -l 25 --sort desc # List with options

View the users in your workspace:

asana users list # List all the users
asana users list -l 25 --sort desc # List with options

For more usage:

asana help # Show all available commands

Contributing

If something feels off, you see an opportunity to improve performance, or think some functionality is missing, we’d love to hear from you! Please review our contributing docs for detailed instructions on how to provide feedback or submit a pull request. Thank you!

License

This project is licensed under the MIT License. See the LICENSE file for details.