Collaborators

The wit collaborator command lets you manage who has access to your repository, their roles and permissions, and organize collaborators into teams.

Overview

wit collaborator <command> [options]

Roles and Permissions

wit supports five role levels with different permissions:

Role	Description
Owner	Full control, can delete repository
Admin	Manage settings and collaborators
Maintainer	Merge PRs, manage releases
Contributor	Push to branches, create PRs
Viewer	Read-only access

Permission Matrix

Permission	Owner	Admin	Maintainer	Contributor	Viewer
Read	Yes	Yes	Yes	Yes	Yes
Write	Yes	Yes	Yes	Yes	-
Push	Yes	Yes	Yes	Yes	-
Push Protected	Yes	Yes	Yes	-	-
Merge	Yes	Yes	Yes	-	-
Create Branch	Yes	Yes	Yes	Yes	-
Delete Branch	Yes	Yes	Yes	-	-
Create Tag	Yes	Yes	Yes	-	-
Delete Tag	Yes	Yes	-	-	-
Manage Releases	Yes	Yes	Yes	-	-
Manage Settings	Yes	Yes	-	-	-
Manage Collaborators	Yes	Yes	-	-	-
Delete Repository	Yes	-	-	-	-

Commands

list

List all collaborators in the repository.

wit collaborator
wit collaborator list [options]

Options

Option	Description
`-v, --verbose`	Show detailed information

Examples

# List all collaborators
wit collaborator

# List with details (join date, activity, teams)
wit collaborator list -v

Example Output

Active Collaborators
────────────────────────────────────────────────────────────
  [owner] Alice <alice@example.com>
  [maintainer] Bob <bob@example.com>
  [contributor] Charlie <charlie@example.com>

Pending Invitations
────────────────────────────────────────────────────────────
  [contributor] dave@example.com (pending) 6 days left

add / invite

Invite a new collaborator to the repository.

wit collaborator add <email> [options]
wit collaborator invite <email> [options]

Options

Option	Description
`--role, -r <role>`	Role to assign (default: contributor)
`--message, -m <text>`	Personal message in the invitation
`--name <name>`	Display name for the collaborator
`--skip-email`	Don’t send invitation email

Examples

# Invite as contributor (default)
wit collaborator add bob@example.com

# Invite as maintainer
wit collaborator add bob@example.com --role maintainer

# Invite with a message
wit collaborator add bob@example.com -m "Welcome to the team!"

# Invite without sending email
wit collaborator add bob@example.com --skip-email

Example Output

Invited bob@example.com as [contributor]
  (Email notifications not configured)

Invitation token (share this with the invitee):
  wit_inv_a1b2c3d4e5f6...

They can accept with:
  wit collaborator accept wit_inv_a1b2c3d4e5f6...

remove

Remove a collaborator from the repository.

wit collaborator remove <email>
wit collaborator rm <email>

Examples

wit collaborator remove bob@example.com

update

Update a collaborator’s role.

wit collaborator update <email> --role <role>

Examples

# Promote to maintainer
wit collaborator update bob@example.com --role maintainer

# Demote to viewer
wit collaborator update bob@example.com --role viewer

show

Show detailed information about a specific collaborator.

wit collaborator show <email>

Example Output

Bob Smith
bob@example.com

Role:        [maintainer]
Status:      active
Invited:     2 weeks ago by alice@example.com
Accepted:    2 weeks ago
Last active: 3 hours ago
Teams:       frontend, reviewers

Permissions
────────────────────────────────────────
  Read
  Write
  Push
  Push Protected
  Merge
  Create Branch
  Delete Branch
  Create Tag
  Manage Releases

accept

Accept an invitation to join a repository.

wit collaborator accept <token> [--name <name>]

Examples

# Accept with token
wit collaborator accept wit_inv_a1b2c3d4e5f6...

# Accept and set display name
wit collaborator accept wit_inv_a1b2c3d4e5f6... --name "Bob Smith"

revoke

Revoke a pending invitation.

wit collaborator revoke <email>

Examples

wit collaborator revoke bob@example.com

invitations

List all pending invitations.

wit collaborator invitations

Example Output

Pending Invitations
────────────────────────────────────────────────────────────
  bob@example.com
    Role: [contributor]
    Invited by: alice@example.com
    Expires: 6 days left

  charlie@example.com
    Role: [viewer]
    Invited by: alice@example.com
    Expires: 2 days left
    Message: "Welcome to the project!"

activity

Show recent collaborator activity.

wit collaborator activity [-n <limit>]

Options

Option	Description
`-n <number>`	Number of entries to show (default: 20)

Example Output

Recent Activity
────────────────────────────────────────────────────────────
  alice@example.com invited bob@example.com as contributor
    2 hours ago

  bob@example.com accepted invitation
    1 hour ago

  alice@example.com changed charlie@example.com's role from contributor to maintainer
    30 minutes ago

stats

Show collaborator statistics.

wit collaborator stats

Example Output

Collaborator Statistics
────────────────────────────────────────
  Total:      8
  Active:     6
  Pending:    2
  Teams:      3

By Role
────────────────────────────────────────
  [owner] 1
  [admin] 1
  [maintainer] 2
  [contributor] 3
  [viewer] 1

config

View or update collaborator settings.

wit collaborator config [key] [value]

Configuration Keys

Key	Description
`public-access`	Allow public read access (yes/no)
`default-role`	Default role for new collaborators
`invite-expiration`	Days until invitation expires
`email-enabled`	Enable email notifications (yes/no)
`resend-api-key`	Resend API key for emails
`email-from`	From email address
`email-from-name`	From display name
`repository-name`	Repository name in emails
`repository-url`	Repository URL in emails

Examples

# View current configuration
wit collaborator config

# Set default role
wit collaborator config default-role maintainer

# Set invitation expiration to 14 days
wit collaborator config invite-expiration 14

# Enable email notifications
wit collaborator config email-enabled yes
wit collaborator config resend-api-key re_xxxxx
wit collaborator config email-from noreply@mycompany.com

Team Commands

Organize collaborators into teams for easier permission management.

team list

List all teams.

wit collaborator team list
wit collaborator team

Example Output

Teams
──────────────────────────────────────────────────
  Frontend (frontend)
    Role: [maintainer]
    Members: 3
    Description: Frontend development team

  Reviewers (reviewers)
    Role: [contributor]
    Members: 5

team create

Create a new team.

wit collaborator team create <name> [options]

Options

Option	Description
`--role, -r <role>`	Team role (default: contributor)
`--description <text>`	Team description

Examples

# Create a team with default role
wit collaborator team create "Code Reviewers"

# Create a team with maintainer role
wit collaborator team create "Core Team" --role maintainer

# Create with description
wit collaborator team create "QA" --role contributor --description "Quality assurance team"

team delete

Delete a team.

wit collaborator team delete <slug>

Examples

wit collaborator team delete frontend

Deleting a team does not remove the collaborators, only their team membership.

team add-member

Add a collaborator to a team.

wit collaborator team add-member <team-slug> <email>

Examples

wit collaborator team add-member frontend bob@example.com

team remove-member

Remove a collaborator from a team.

wit collaborator team remove-member <team-slug> <email>

Examples

wit collaborator team remove-member frontend bob@example.com

Workflow Examples

Setting Up a New Project

# Add core team members
wit collaborator add alice@example.com --role admin
wit collaborator add bob@example.com --role maintainer

# Create teams
wit collaborator team create "Core" --role maintainer
wit collaborator team create "Contributors" --role contributor

# Add members to teams
wit collaborator team add-member core alice@example.com
wit collaborator team add-member core bob@example.com

Onboarding a New Developer

# Invite the developer
wit collaborator add newdev@example.com --role contributor \
  -m "Welcome! Check out README.md to get started."

# The new developer accepts
# (on their machine)
wit collaborator accept wit_inv_xxxxx --name "New Developer"

# Optionally add to a team
wit collaborator team add-member contributors newdev@example.com

Promoting a Contributor

# Check their current status
wit collaborator show dev@example.com

# Promote to maintainer
wit collaborator update dev@example.com --role maintainer

# Add to core team
wit collaborator team add-member core dev@example.com

Environment Variables

Variable	Description
`WIT_AUTHOR_EMAIL`	Your email for activity logs
`WIT_AUTHOR_NAME`	Your name for activity logs
`GIT_AUTHOR_EMAIL`	Fallback for author email
`GIT_AUTHOR_NAME`	Fallback for author name

wit token - Manage personal access tokens
wit pr - Pull requests (requires collaborator access)
wit push - Push changes (requires write access)

​Overview

​Roles and Permissions

​Permission Matrix

​Commands

​list

​Options

​Examples

​Example Output

​add / invite

​Options

​Examples

​Example Output

​remove

​Examples

​update

​Examples

​show

​Example Output

​accept

​Examples

​revoke

​Examples

​invitations

​Example Output

​activity

​Options

​Example Output

​stats

​Example Output

​config

​Configuration Keys

​Examples

​Team Commands

​team list

​Example Output

​team create

​Options

​Examples

​team delete

​Examples

​team add-member

​Examples

​team remove-member

​Examples

​Workflow Examples

​Setting Up a New Project

​Onboarding a New Developer

​Promoting a Contributor

​Environment Variables

​Related Commands

Overview

Roles and Permissions

Permission Matrix

Commands

list

Options

Examples

Example Output

add / invite

Options

Examples

Example Output

remove

Examples

update

Examples

show

Example Output

accept

Examples

revoke

Examples

invitations

Example Output

activity

Options

Example Output

stats

Example Output

config

Configuration Keys

Examples

Team Commands

team list

Example Output

team create

Options

Examples

team delete

Examples

team add-member

Examples

team remove-member

Examples

Workflow Examples

Setting Up a New Project

Onboarding a New Developer

Promoting a Contributor

Environment Variables

Related Commands