Skip to main content

Synopsis

Description

Opens an interactive TUI for the current organization. Lists every member with their role and project count, lets you expand a member to see their per-project roles and protected-branch grants, and lets you change anything from the keyboard. If stdout isn’t a TTY (e.g., piped to a file), Capy falls back to a static rendering of the same table.

Example

Expanding a row

Pressing Enter on a row expands it to show that member’s project roles and the protected branches they have grants on:
(org-wide) branches need no grant - anyone in the org can read them. (granted) and (no access) only appear on protected branches.

Changing a role

Pressing r on a member or project row inline-edits the role with an arrow-key picker. Selections apply on Enter:
Picking remove from the org-level role picker has the same effect as capy kick <email>. Picking remove from a per-project picker only revokes that project’s role; the member stays in the org.

Granting a protected branch

Move the cursor onto a (no access) branch row and press g. The status flips to (granted). Press g again to revoke. Same operation as the non-interactive capy grant-branch / capy revoke-branch commands.

Keys

Non-interactive use

Pipe the command and Capy writes a static rendering with no footer hints:
The static output is the same table, no cursor, no prompts. Useful in CI to snapshot org state.
Last modified on May 20, 2026