People & places

These three groups are read-only. They exist mainly to find the GIDs the write commands need.

Users

cyber-asana user me
cyber-asana user list
cyber-asana user get <gid>

Command	Arguments	Options
me	—	—
list	—	--workspace-gid <gid> / --workspace <gid>, plus the pagination options
get	<gid>	—

user me returns the authenticated user — the quickest way to confirm your token works and to get your own GID for --assignee.

user list pages through Asana’s GET /users?workspace= endpoint, sorted by user ID, so it works on workspaces with tens of thousands of members. To assign work by name without paging at all, register the people you assign to once with config add-user.

Teams

cyber-asana team list
cyber-asana team get <gid>

Command	Arguments	Options
list	—	--workspace-gid <gid> / --workspace <gid>, pagination
get	<gid>	—

Workspaces

cyber-asana workspace list
cyber-asana workspace get <gid>

Command	Arguments	Options
list	—	pagination
get	<gid>	—

workspace list is the one command that needs no workspace context — start here, then set ASANA_WORKSPACE_GID to the GID you want so you can drop --workspace-gid from every other command.

export ASANA_WORKSPACE_GID="$(cyber-asana workspace list --json | jq -r '.data[0].gid')"

Membership edits (adding or removing users from teams and workspaces) are not wrapped — see API coverage.