Common Issues

Quick solutions for frequently encountered problems.

Reviews

Review stuck on "Processing"

Symptoms: Review shows processing for more than 15 minutes.

Solutions:

1. Check the process log for errors
2. Cancel and re-trigger the review
3. Try a lower tier (Quick Scan)

If persists: Contact support with the review ID.

Review failed immediately

Symptoms: Review shows "Failed" status right after starting.

Common causes:

• Insufficient credits
• PR diff too large
• GitHub API rate limit

Solutions:

1. Check your credit balance
2. For large PRs, try Quick Scan first
3. Wait a few minutes and retry

No findings on obvious issues

Symptoms: Review completes but misses clear problems.

Solutions:

1. Try a higher tier (Code Review or Deep Analysis)
2. Enable repository access for more context
3. Add a focus prompt to guide the review

Duplicate reviews

Symptoms: Same PR reviewed multiple times.

Causes:

• Both webhook and slash command triggered
• PR updated during review

Prevention:

• Reviews auto-deduplicate within 60 seconds
• Consider disabling auto-review if using slash commands

Repositories

Repository not appearing in list

Symptoms: Can't see a repository to connect.

Solutions:

1. Ensure you have write access to the repo
2. For org repos, check if admin approval is needed
3. Try the Refresh button
4. Reconnect your GitHub account in Settings

Webhook not triggering reviews

Symptoms: PRs opened but no automatic review.

Check:

1. Repository is not paused
2. Auto-review is enabled in repo settings
3. GitHub App is still installed

Debug:

1. Go to GitHub repo settings > Webhooks
2. Check recent deliveries for errors
3. Verify the webhook URL is correct

"Not authorized" error

Symptoms: Error when connecting or accessing repository.

Solutions:

1. Reconnect GitHub in Settings
2. Re-authorize the GitHub App
3. Ensure you haven't revoked access

Billing

"Insufficient credits" error

Symptoms: Can't start review due to low balance.

Solutions:

1. Purchase more credits in Billing
2. Enable auto top-up to prevent this
3. Use BYOK to bypass credit system

Payment failed

Symptoms: Credit purchase didn't complete.

Solutions:

1. Check your card details in Stripe
2. Ensure sufficient funds
3. Try a different payment method

Credits not appearing after purchase

Symptoms: Bought credits but balance unchanged.

Solutions:

1. Refresh the page
2. Check email for receipt (confirms purchase)
3. Wait a few minutes for processing

If still missing: Contact support with your receipt.

API & Integration

BYOK key not working

Symptoms: Reviews fail with API key error.

Check:

1. Key is valid in Anthropic console
2. Key has sufficient quota
3. Key wasn't recently rotated

Solutions:

1. Remove and re-add the key
2. Generate a new key in Anthropic console
3. Check Anthropic account status

GitHub token expired

Symptoms: Banner shows "GitHub connection expired."

Solution:

1. Click Reconnect in Settings
2. Re-authorize through GitHub
3. Your data is preserved

Performance

Reviews taking too long

Symptoms: Code Review taking 10+ minutes.

Factors:

• Large diff size
• Many files affected
• Complex repository

Solutions:

1. Use Quick Scan for simple changes
2. Split large PRs into smaller ones
3. Configure file exclusions

Dashboard loading slowly

Symptoms: Pages take long to load.

Solutions:

1. Check your internet connection
2. Clear browser cache
3. Try a different browser

Getting Help

If your issue isn't listed:

1. Check our FAQ
2. Email support@assay.it with:
   • Your GitHub username
   • Review ID (if applicable)
   • Steps to reproduce
   • Screenshots if helpful