Get Started

Integrations

VS Code Extension MCP Server @codepeel Chat

Configuration

.codepeel.yml Pre-merge Checks Learnings

Automation

Auto-Test Auto-Fix

Reference

Security FAQ

Teams

CodePeel supports shared GitHub App installations so multiple developers can collaborate on the same repositories. Each team member sees shared repos on their dashboard, receives reviews on the PRs they author, and is billed independently from their own plan quota. Teams form organically when multiple CodePeel users connect to the same GitHub organization or account — no separate "team plan" or invitation system required.

How It Works

When you install the CodePeel GitHub App on a GitHub organization or personal account, you become the owner of that installation. Other developers who sign up for CodePeel and connect to the same GitHub account are automatically added as members.

Both owners and members see the same repositories on their dashboards. Each person is only charged for the pull requests they personally open.

Roles

CodePeel defines two roles within a shared installation, determined automatically by who connected first.

Owner

The first CodePeel user to install the GitHub App on a given GitHub account/organization
Exactly one owner per installation
Serves as the billing fallback: when an external contributor without a CodePeel account opens a PR, the review is charged to the owner's quota

Member

Any CodePeel user who joins an existing installation after the owner
Receives reviews on their own PRs, charged against their own plan
Can leave the installation at any time (removes shared repos from dashboard, preserves review history)

Billing for Teams

CodePeel uses author-based billing for shared installations. Each developer's PR reviews are charged to their own CodePeel plan, regardless of who owns the installation.

Billing Resolution

When a PR is opened on a connected repository, CodePeel looks for a CodePeel account linked to the PR author's GitHub identity and charges that account. If no CodePeel account is found (external contributor, bot, or unfamiliar account), the installation owner is charged.

Billing Examples

Person	Role	Plan	Action	Who is Charged
Alice	Owner	Max (unlimited)	Opens a PR	Alice
Bob	Member	Pro (500/month)	Opens a PR	Bob
Charlie	Member	Free (30/month)	Opens a PR	Charlie
External contractor (no CodePeel account)	N/A	N/A	Opens a PR	Alice (owner fallback)

Each person's review count increments independently. The owner only absorbs cost when the PR author has no CodePeel account.

Joining a Team

Method 1: Owner adds member (recommended)

Member signs up for CodePeel (any plan)
Owner goes to Repositories page → Team panel → Add member
Owner enters member's GitHub username or signup email
CodePeel adds them immediately (member must have a CodePeel account)

Method 2: Member joins from their dashboard

Member signs up for CodePeel
Navigates to Repositories → Join a team
Enters the owner's GitHub username
CodePeel finds the installation and adds the member

Method 3: Self-join via GitHub (new installations only)

When a member connects to a GitHub account where CodePeel is being installed for the first time, GitHub redirects them back to CodePeel and they are added automatically. Limitation: GitHub only redirects on new installations. For existing teams, use Method 1 or 2.

Installation Owner Setup

One person must first install the CodePeel GitHub App:

Sign in at codepeel.com/app
Go to Repositories → Connect
Authorize CodePeel on GitHub
Select the organization/account and repositories
Click Install

After installation, repositories appear on the owner's dashboard within seconds.

Troubleshooting

Connected but not added as member

GitHub only redirects to CodePeel for new installations. If the app is already installed (common for existing teams), GitHub shows its config page instead. Fix: use Join a team button or have the owner add you.

Connected but no repositories visible

You likely selected a different GitHub account than where CodePeel is installed. Have the owner add you, or reconnect with the correct account.

Reviews not showing on my dashboard

Reviews appear on the dashboard of the GitHub account that authored the PR — not the CodePeel account you're signed into. Ensure you're logged into GitHub with the same account shown in your Team panel.

Owner changed GitHub username

No effect. CodePeel matches authors by a stable identifier, so username changes don't disrupt billing.

Multiple GitHub accounts

Each GitHub account/organization needs its own CodePeel installation. You can be owner or member of multiple installations simultaneously — all appear on your dashboard.

Member left but past reviews still visible

Expected. Leaving only removes future repo visibility. All review history remains in their account permanently.

FAQ

Do members need a paid plan? No. Members can join on Free tier (30 reviews/month). They are limited by their own quota. The owner's plan does not extend to members.

Can one person be in multiple installations? Yes. Reviews across all installations draw from a single shared monthly quota on your own plan.

What if a member exhausts their quota? Their PRs are not reviewed until quota resets (1st of next month) or they upgrade. Other members unaffected. Owner's quota is not a secondary pool.

Can the owner see members' review content? No. Reviews are stored privately per user. Team panel shows only aggregate usage statistics.

Why did my review go to the owner instead of me? You created the PR while logged into a different GitHub account than your CodePeel identity. Always open PRs from the GitHub account shown in your Team panel.

Is there a member limit? No enforced limit. Any CodePeel user with access to the GitHub organization can join.