Collaboration
Collaboration
Work with your team directly from the CLI: comment on tasks, manage who gets notified, and categorize work with tags.
Comments
Comments are stored as Asana stories on a task. The CLI lists only user comments, filtering out system activity such as assignment changes.
Add a Comment
bun run dev task comment add TASK_ID "This is a comment"
Add a Rich Text Comment
Pass --html to send Asana HTML rich text. The CLI wraps your markup in the
required <body> element automatically:
bun run dev task comment add TASK_ID "Deploy is <strong>done</strong>" --html
See the Asana rich text guide for the supported HTML subset.
List Comments
bun run dev task comment list TASK_ID
Output includes the comment author and creation timestamp.
Followers
Followers (collaborators) receive notifications when a task changes. Users can
be referenced by numeric GID, email address, or me.
# Add a follower
bun run dev task follower add TASK_ID USER_ID
# Remove a follower
bun run dev task follower remove TASK_ID USER_ID
# List followers
bun run dev task follower list TASK_ID
Tags
Tags categorize tasks across projects. Each tag belongs to a workspace.
Tag CRUD
# List workspace tags (uses default workspace when -w is omitted)
bun run dev tag list --workspace WORKSPACE_ID
# Create a tag
bun run dev tag create --name "urgent" --color dark-red
# Inspect a tag
bun run dev tag get TAG_ID
# Rename or recolor a tag
bun run dev tag update TAG_ID --name "high-priority" --color light-orange
# Delete a tag
bun run dev tag delete TAG_ID
Assign Tags to Tasks
# Add a tag to a task
bun run dev task tag add TASK_ID TAG_ID
# Remove a tag from a task
bun run dev task tag remove TASK_ID TAG_ID
# List tags on a task
bun run dev task tag list TASK_ID
Tag Colors
red are rejected. The CLI validates the color before calling the API.Valid colors:
dark-pink, dark-green, dark-blue, dark-red, dark-teal, dark-brown,
dark-orange, dark-purple, dark-warm-gray, light-pink, light-green,
light-blue, light-red, light-teal, light-brown, light-orange,
light-purple, light-warm-gray
Example Workflow
# 1. Create a tag for urgent work
bun run dev tag create --name "urgent" --color dark-red
# 2. Tag a task and notify a teammate
bun run dev task tag add TASK_ID TAG_ID
bun run dev task follower add TASK_ID teammate@example.com
# 3. Discuss progress in the comments
bun run dev task comment add TASK_ID "Picking this up now"
bun run dev task comment list TASK_ID
Related
- Task Management - Core task operations
- Subtasks & Dependencies - Task hierarchies
- Quick Start - Basic command examples