Teams, Workspaces & Users
Teams, Workspaces & Users
Explore your organization structure: list workspaces, browse teams and their members, and look up users with fuzzy search.
Workspaces
List Workspaces
bun run dev workspace list
# Skip the local cache and fetch fresh data
bun run dev workspace list --no-cache
Workspace lists are cached locally for 5 minutes (~/.asana-cli/cache.json)
to avoid repeated API calls. Use --no-cache when you need live data.
Get Workspace Details
bun run dev workspace get WORKSPACE_ID
List Workspace Users
# Explicit workspace
bun run dev workspace users WORKSPACE_ID
# Uses the configured default workspace
bun run dev workspace users
Set the Default Workspace
Most commands accept -w/--workspace; setting a default removes the need to
pass it every time:
bun run dev workspace set-default WORKSPACE_ID
The CLI verifies the workspace is accessible, then saves it to
~/.asana-cli/config.json.
Teams
Teams are only available in organization workspaces.
List Teams
bun run dev team list --workspace WORKSPACE_ID
# With a default workspace configured
bun run dev team list
# Bypass the 5-minute team cache
bun run dev team list --no-cache
Get Team Details
bun run dev team get TEAM_ID
Returns name, description, organization, visibility, and permalink URL.
List Team Members
bun run dev team members TEAM_ID
Users
Current User
bun run dev user me
Get a User
Accepts a GID, an email address, or the literal me:
bun run dev user get 1234567890
bun run dev user get john@example.com
bun run dev user get me
Search Users (Fuzzy)
Searches workspace users by name or email. Matching is case-insensitive and ranks exact matches above prefix, substring, and subsequence matches:
bun run dev user search "john" --workspace WORKSPACE_ID
bun run dev user search "john@example.com"
List a User's Tasks
# Incomplete tasks assigned to a user
bun run dev user tasks USER_ID --workspace WORKSPACE_ID
# Include completed tasks
bun run dev user tasks me --completed
Output Formats
All commands honor the global --format flag (toon by default, plus json
and plain):
bun run dev workspace list -f json
bun run dev team members TEAM_ID -f plain