Features

팀, 워크스페이스 & 사용자

Asana CLI로 팀, 워크스페이스, 사용자를 관리하세요

팀, 워크스페이스 & 사용자

조직 구조를 탐색하세요: 워크스페이스 목록 조회, 팀과 팀 멤버 확인, 퍼지 검색을 통한 사용자 조회를 지원합니다.

워크스페이스

워크스페이스 목록

bun run dev workspace list

# 로컬 캐시를 건너뛰고 최신 데이터 조회
bun run dev workspace list --no-cache

워크스페이스 목록은 반복적인 API 호출을 줄이기 위해 로컬에 5분간 캐시됩니다 (~/.asana-cli/cache.json). 실시간 데이터가 필요하면 --no-cache를 사용하세요.

워크스페이스 상세 조회

bun run dev workspace get WORKSPACE_ID

워크스페이스 사용자 목록

# 워크스페이스 명시
bun run dev workspace users WORKSPACE_ID

# 설정된 기본 워크스페이스 사용
bun run dev workspace users

기본 워크스페이스 설정

대부분의 명령어는 -w/--workspace 옵션을 지원합니다. 기본 워크스페이스를 설정하면 매번 전달할 필요가 없습니다:

bun run dev workspace set-default WORKSPACE_ID

CLI가 워크스페이스 접근 가능 여부를 확인한 후 ~/.asana-cli/config.json에 저장합니다.

팀은 조직(organization) 워크스페이스에서만 사용할 수 있습니다.

팀 목록

bun run dev team list --workspace WORKSPACE_ID

# 기본 워크스페이스가 설정된 경우
bun run dev team list

# 5분 팀 캐시 우회
bun run dev team list --no-cache

팀 상세 조회

bun run dev team get TEAM_ID

이름, 설명, 조직, 공개 범위, 영구 링크 URL을 반환합니다.

팀 멤버 목록

bun run dev team members TEAM_ID

사용자

현재 사용자

bun run dev user me

사용자 조회

GID, 이메일 주소, 또는 me 리터럴을 사용할 수 있습니다:

bun run dev user get 1234567890
bun run dev user get john@example.com
bun run dev user get me

사용자 검색 (퍼지)

이름 또는 이메일로 워크스페이스 사용자를 검색합니다. 대소문자를 구분하지 않으며 정확 일치 > 접두사 > 부분 문자열 > 부분 수열 순으로 순위를 매깁니다:

bun run dev user search "john" --workspace WORKSPACE_ID
bun run dev user search "john@example.com"

사용자의 태스크 목록

# 사용자에게 할당된 미완료 태스크
bun run dev user tasks USER_ID --workspace WORKSPACE_ID

# 완료된 태스크 포함
bun run dev user tasks me --completed

출력 형식

모든 명령어는 전역 --format 플래그를 지원합니다 (기본 toon, 추가로 jsonplain):

bun run dev workspace list -f json
bun run dev team members TEAM_ID -f plain
Copyright © 2026