nkapp team

Manage teams and role-based access (RBAC) from the CLI. Invite collaborators, assign roles, and switch the active team context used by other commands.


nkapp team <subcommand> [options]

Requires an authenticated account session — run nkapp auth login first.

Team roles (owner / admin / deployer / viewer) are scoped to the team. They are distinct from your account’s global plan or any platform-staff role.

The active team

nkapp team switch stores the selected team in ~/.nanokit/active-team.json. All membership-scoped subcommands default to this team; override it per command with --team <id|slug>.


nkapp team switch acme-inc     # set the active team
nkapp team current             # show the active team context

Subcommands

Subcommand	Description
`team list` (alias `ls`)	List the teams you belong to (the active one is marked)
`team current`	Show the active team context
`team create <name>`	Create a team (requires a Teams account) and switch to it
`team switch <id\|slug>` (alias `use`)	Set the active team
`team members`	List members and pending invites of the active team
`team invite <email> [-r <role>]`	Invite a user by email (`admin`, `deployer`, or `viewer`; default `viewer`)
`team accept <token>`	Accept an invite by its token
`team revoke <inviteId>`	Revoke a pending invite
`team role <userId> <role>`	Change a member’s role
`team remove <userId>` (alias `rm`)	Remove a member from the team
`team leave`	Leave the active team
`team transfer <newOwnerUserId>`	Transfer ownership to another member (owner only)
`team rename <name>`	Rename the active team
`team delete [-y]`	Delete the active team (owner only; `-y` skips confirmation)

Options

Flag	Description
`--api <url>`	Override the API base URL (available on every subcommand)
`--team <id\|slug>`	Target a specific team instead of the active one (membership-scoped subcommands)
`-r, --role <role>`	Role to grant on `invite` (`admin` \| `deployer` \| `viewer`, default `viewer`)
`-y, --yes`	Skip the confirmation prompt on `delete`

Examples


# See your teams and pick one
nkapp team list
nkapp team switch acme-inc
 
# Bring a teammate on board with deploy rights
nkapp team invite jane@example.com -r deployer
 
# Audit membership
nkapp team members
 
# Promote a member, then hand over the team
nkapp team role usr_123 admin
nkapp team transfer usr_123

[!NOTE] The CLI is a thin client: membership and permissions are always enforced server-side by the Nanokit backend. The CLI only resolves the active-team context and renders results.