@amondnet/asana-cli-docs
Features

Task Management

Complete task management operations with Asana CLI

Task Management

Comprehensive task management features for creating, listing, completing, and deleting Asana tasks from the command line.

Create Tasks

Basic Task Creation

Create a simple task with just a name:

bun run dev task create -n "Task name" -w WORKSPACE_ID

Task with Description

bun run dev task create \
  -n "Implement authentication" \
  -d "Add OAuth 2.0 and JWT support for user authentication" \
  -w WORKSPACE_ID

Task in a Project

Assign a task to a specific project:

bun run dev task create \
  -n "Fix login bug" \
  -p PROJECT_ID \
  -w WORKSPACE_ID

Task with Assignee

Assign a task to a specific user:

bun run dev task create \
  -n "Review code changes" \
  -a USER_ID \
  -w WORKSPACE_ID

Task with Due Date

Set a deadline for the task:

bun run dev task create \
  -n "Submit quarterly report" \
  --due 2025-12-31 \
  -w WORKSPACE_ID

Complete Task Creation

Create a task with all options:

bun run dev task create \
  -n "Update user documentation" \
  -d "Add examples and screenshots to user guide" \
  -p PROJECT_ID \
  -a USER_ID \
  --due 2025-11-30 \
  -w WORKSPACE_ID

출력 포맷

모든 작업 명령어는 --format 플래그를 통해 다양한 출력 포맷을 지원합니다:

TOON 포맷 (기본값)

LLM 상호작용에 최적화된 토큰 효율적 포맷 (JSON 대비 30-60% 토큰 감소):

bun run dev task list -a me -w WORKSPACE_ID --format toon

출력 예시:

tasks[3]{gid,name,completed}:
  "1234567890",인증 설정,true
  "1234567891",작업 명령어 추가,false
  "1234567892",문서 작성,false

JSON 포맷

스크립트 및 자동화를 위한 기계 판독 가능 포맷:

bun run dev task list -a me -w WORKSPACE_ID --format json

출력 예시:

{
  "tasks": [
    { "gid": "1234567890", "name": "인증 설정", "completed": true },
    { "gid": "1234567891", "name": "작업 명령어 추가", "completed": false }
  ]
}

Plain 포맷

전통적인 사람이 읽기 편한 CLI 출력:

bun run dev task list -a me -w WORKSPACE_ID --format plain

출력 예시:

Tasks (3):

✓ 1234567890 - 인증 설정
○ 1234567891 - 작업 명령어 추가
○ 1234567892 - 문서 작성

List Tasks

List Your Tasks

View all tasks assigned to you:

bun run dev task list -a me -w WORKSPACE_ID

List Project Tasks

View all tasks in a specific project:

bun run dev task list -p PROJECT_ID

완료 상태로 필터링

미완료 또는 완료 작업만 조회합니다:

bun run dev task list -p PROJECT_ID --incomplete-only
bun run dev task list -p PROJECT_ID --completed-only

-c, --completed 플래그는 폐기 예정입니다. 이름과 달리 완료된 작업을 제외하므로 --incomplete-only를 사용하세요.

담당자로 필터링

-a 옵션은 me, 사용자 GID 외에 미할당 작업을 뜻하는 none도 지원합니다:

bun run dev task list -p PROJECT_ID -a none

필드 확장

--fields로 목록에 추가 필드를 포함하면 작업마다 task get을 호출할 필요가 없습니다:

bun run dev task list -p PROJECT_ID --fields completed,assignee,due_on

개수 집계

행 목록 대신 합계를 반환합니다:

bun run dev task list -p PROJECT_ID --count
bun run dev task list -p PROJECT_ID --incomplete-only --group-by assignee --format json

출력 예시:

{
  "summary": {
    "total": 12,
    "groups": [
      { "assignee": "Alice", "count": 7 },
      { "assignee": "unassigned", "count": 5 }
    ]
  }
}

List Tasks for Another User

View tasks assigned to a specific user:

bun run dev task list -a USER_ID -w WORKSPACE_ID

View Task Details

Get detailed information about a specific task:

bun run dev task get TASK_ID

This displays:

  • Task name
  • Description
  • Assignee
  • Due date
  • Projects
  • Completion status
  • Created and modified dates

Complete Tasks

Mark a task as complete:

bun run dev task complete TASK_ID

The task will be marked as completed but remains in the system for record-keeping.

Delete Tasks

Permanently delete a task:

bun run dev task delete TASK_ID
Warning: This action cannot be undone. The task will be permanently removed from Asana.

Command Options

Common Options

All task commands support these options:

  • -w, --workspace <id> - Workspace ID (required for most operations)
  • -p, --project <id> - Project ID
  • -a, --assignee <id> - User ID or "me" for yourself

Create Options

  • -n, --name <string> - Task name (required)
  • -d, --description <string> - Task description
  • --due <date> - Due date (YYYY-MM-DD format)

List Options

  • -c, --completed - Include completed tasks

Practical Examples

Daily Standup Workflow

# Check your tasks for today
bun run dev task list -a me -w WORKSPACE_ID

# Create follow-up tasks
bun run dev task create -n "Follow up on PR review" -w WORKSPACE_ID

# Complete finished tasks
bun run dev task complete TASK_ID

Project Management

# View all project tasks
bun run dev task list -p PROJECT_ID

# Add new task to project
bun run dev task create \
  -n "Implement search feature" \
  -p PROJECT_ID \
  -w WORKSPACE_ID

Team Collaboration

# Assign task to team member
bun run dev task create \
  -n "Review API documentation" \
  -a TEAM_MEMBER_ID \
  --due 2025-10-30 \
  -w WORKSPACE_ID

Tips & Best Practices

Pro Tip: Use environment variables to avoid repeating workspace IDs:

export ASANA_WORKSPACE=your_workspace_id

Then you can omit the -w flag in many commands (depending on implementation).

Finding IDs:

  • Workspace ID: Check the URL when viewing your workspace in Asana
  • Project ID: Look at the URL when viewing a project
  • User ID: Available through the Asana API or web interface ::

Related

Quick Start

Learn the essential commands to manage your Asana tasks from the CLI

Authentication

Authentication methods and credential management for Asana CLI

Copyright © 2026