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
Organization Members (3 users)
Email Role Added Projects
─────────────────────────────────────────────────────────────────────
> alice@acme.com owner 2025-01-15 2 projects
bob@acme.com member 2025-02-03 1 project
carol@acme.com admin 2025-03-10 2 projects
─────────────────────────────────────────────────────────────────────
↑↓ navigate Enter expand/collapse r change role g grant protected q quit
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:
> alice@acme.com owner 2025-01-15 2 projects
api-backend admin
main (org-wide)
production (granted)
web-frontend member
main (org-wide)
production (no access)
(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:
> bob@acme.com ❯ admin 1 project
project-admin
member
remove
↑↓ pick role Enter confirm Esc cancel
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
| Key | What it does |
|---|
↑ / ↓ | Move the cursor |
Enter | Expand or collapse the row under the cursor |
r | Change the role for the selected row (member or per-project) |
g | Toggle a protected-branch grant for the selected branch row |
Esc | Cancel the current edit |
q or Ctrl-C | Quit |
Non-interactive use
Pipe the command and Capy writes a static rendering with no footer hints:
capy users | tee members.txt
Last modified on May 20, 2026
