Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.capy.sc/llms.txt

Use this file to discover all available pages before exploring further.

Synopsis

capy grant-branch <email> <project> <branch>

Description

Grants <email> access to the named protected branch in the named project. Non-interactive - same operation as pressing g on a (no access) row in capy users, but scriptable for CI. The user must already be a member of the org. Granting access to a non-protected branch is a no-op; non-protected branches are visible to every member by default.

Example

$ capy grant-branch alice@acme.com web-frontend production
Granted alice@acme.com access to web-frontend/production

Failure modes

Exit reasonCause
Project "<name>" not foundThe project name doesn’t match any project in this org
Branch "<name>" not found in projectThe branch doesn’t exist in that project
No member with email "<email>"The user isn’t a member of this org - invite them first
Authentication failedYour local session expired; run capy to re-auth
All exits are non-zero on failure, suitable for CI.

See also