Managing your team
Invite members, assign roles, and let GitHub control who sees what. Repository access syncs automatically from your GitHub organization, so you manage permissions in one place.
Adding members
To invite a team member:
- Go to Settings → Team in the Prelint dashboard.
- Click Invite member.
- Enter their email address and select a role.
- They'll receive an email invitation to join your organization.
Invited members can sign in with their GitHub account. Their GitHub identity is linked automatically on first login.
Bulk invite
For larger teams, upload a CSV file to invite multiple members at once:
- Go to Settings → Team.
- Click Bulk invite.
- Upload a CSV file with columns:
email,role.
CSV format:
email,role
alice@company.com,admin
bob@company.com,member
carol@company.com,viewerValid roles are admin, member, and viewer. Invalid rows are skipped with an error message.
Roles and permissions
Prelint has three roles. Each role inherits the permissions of the roles below it:
| Permission | Viewer | Member | Admin |
|---|---|---|---|
| View reviews and findings | ✓ | ✓ | ✓ |
| View specs and decisions | ✓ | ✓ | ✓ |
| View team members | ✓ | ✓ | ✓ |
| Edit specs and decisions | — | ✓ | ✓ |
| Edit project settings | — | ✓ | ✓ |
| Connect repositories | — | ✓ | ✓ |
| Invite and remove members | — | — | ✓ |
| Change member roles | — | — | ✓ |
| Manage billing | — | — | ✓ |
| Delete organization | — | — | ✓ |
GitHub permission sync
Prelint syncs repository access from GitHub. Each team member sees only the repositories they have access to in your GitHub organization. This means:
- Repository visibility in Prelint matches GitHub collaborator permissions.
- When a member is added or removed from a GitHub repo, their Prelint access updates automatically.
- Members can only view reviews and specs for repositories they can access on GitHub.
Permission sync runs automatically when the GitHub App is installed and whenever repository access changes.
Repository access is synced from GitHub, but Prelint roles (Admin, Member) are managed separately in the Prelint dashboard.
Removing members
To remove a team member:
- Go to Settings → Team.
- Find the member and click Remove.
- Confirm the removal.
Removed members lose access immediately. Their seat is freed at the end of the current billing cycle. See Billing for proration details.
You cannot remove the last admin from an organization. Transfer the admin role to another member first.