FAQ

Common questions and troubleshooting.

General

What languages does CodePeel support?

CodePeel works with all programming languages. The AI model has been trained on code across all major languages including TypeScript, JavaScript, Python, Go, Rust, Java, C#, Ruby, PHP, Swift, Kotlin, and more.

How accurate are the reviews?

CodePeel aims for high-precision findings — we'd rather miss an issue than flood you with false positives. The strictMode config option increases sensitivity at the cost of more false positives.

Is my code used for training?

No. CodePeel processes your code only to generate the review. Your code is never stored beyond the review session and is never used for model training.

How fast are reviews?

• Secret scanning: Instant (posted before AI analysis)
• Small PRs (< 2000 chars): ~15-30 seconds
• Large PRs: ~30-90 seconds (parallel analysis)

Setup

Do I need an OpenAI API key?

No. CodePeel uses its own AI infrastructure. You don't need to bring your own API key.

How do I install CodePeel on my organization?

Visit github.com/apps/CodePeel and install it for your organization. Organization admins can approve the installation.

Can I use CodePeel on private repositories?

Yes. Private repos (more than 3) require Pro or Max. Free tier is limited to 3 repositories.

Does CodePeel work with GitHub Enterprise?

Currently, CodePeel supports github.com. GitHub Enterprise Server support is on the roadmap.

Configuration

Where do I put .codepeel.yml?

In the root of your repository, same level as package.json or README.md.

Can I have different settings for different branches?

No, .codepeel.yml settings apply to all PRs in the repository regardless of the target branch. You can use base_branches to limit which branches trigger reviews.

How do I skip review for a specific PR?

Include a keyword from ignore_title_keywords in the PR title:

auto_review:
  ignore_title_keywords:
    - WIP
    - "DO NOT REVIEW"

Or start your PR title with "WIP:" to skip the review.

Troubleshooting

Reviews aren't triggering

1. Verify CodePeel is installed for the repository
2. Check that the PR targets a branch in base_branches (default: main, master, develop)
3. Ensure the PR title doesn't contain an ignore_title_keywords match
4. Check your review balance in the dashboard
5. Verify the webhook is active in your repository settings

Inline comments are on the wrong line

CodePeel uses AI-generated line numbers which may be slightly off for large files. The problemCode snippet resolution usually corrects this, but edge cases exist. This improves with each update.

Review is taking too long

Large PRs (> 10,000 lines of diff) may take up to 2 minutes. Consider:

• Breaking large PRs into smaller ones
• Using ignore_paths to exclude generated files

I'm getting too many false positives

Try these settings:

auto_review:
  profile: chill
ignoreFormatting: true

And add ignore rules for patterns that keep triggering:

@codepeel ignore: Don't flag missing JSDoc comments

A review failed with an error

Check the CodePeel dashboard for error details. Common causes:

• Credit balance depleted
• GitHub API rate limit hit (rare)
• Diff too large (over 100,000 characters)

Pricing

Is there a free tier?

Yes — free tier includes 50 reviews/month on up to 3 repositories. No credit card required.

Do team members each need a subscription?

Yes. Each developer subscribes individually at $9.99/user/month. This keeps pricing honest and simple.

Are reviews deducted for public repos?

Yes. Public and private repos are treated the same. The repo visibility only determines which plans can access it (free tier is limited to public repos).