Getting Started

Get up and running with Asana CLI in minutes.

Installation

Install Dependencies

Clone the repository and install dependencies using Bun:

git clone https://github.com/pleaseai/asana.git
cd asana
bun install

Build Executable (Optional)

To compile a standalone binary:

bun run build

This creates an asana executable that can run without Bun installed.

Authentication

Asana CLI supports two authentication methods:

Method 1: Personal Access Token (Recommended)

The quickest and simplest method, perfect for personal use and CLI tools.

Step 1: Generate Token

1. Go to Asana Developer Console
2. Create a new Personal Access Token
3. Copy the token

Step 2: Login with Token

# Development mode
bun run dev auth login --token YOUR_TOKEN

# Or with compiled binary
./asana auth login --token YOUR_TOKEN

Step 3: Set Default Workspace (Optional)

bun run dev auth login --token YOUR_TOKEN -w WORKSPACE_ID

Method 2: OAuth 2.0

For multi-user applications or enhanced security requirements.

Step 1: Create OAuth App

1. Go to Asana Developer Console
2. Create a new OAuth application
3. Set Redirect URI to: http://localhost:8080/callback
4. Copy Client ID and Client Secret

Step 2: Configure Environment

Create a .env file:

cp .env.example .env

Edit .env and add your credentials:

ASANA_CLIENT_ID=your_client_id
ASANA_CLIENT_SECRET=your_client_secret

Or set environment variables directly:

export ASANA_CLIENT_ID=your_client_id
export ASANA_CLIENT_SECRET=your_client_secret

Step 3: Login with OAuth

bun run dev auth login

Your browser will automatically open to the Asana authorization page.

Verify Installation

Check your authentication status:

bun run dev auth whoami

You should see your Asana user information.

Next Steps