Frequently asked questions

Is Codexa really free?

Yes. The hosted version uses only free AI provider tiers (Gemini, Groq) which is enough for ~1,500 reviews per day across all users on the shared instance. If you outgrow that, either bring your own key (BYOK) or self-host.

What languages does Codexa support?

Anything the underlying LLMs understand — which is essentially every mainstream language (Python, TypeScript, JavaScript, Go, Rust, Java, C#, Ruby, PHP, C/C++, Swift, Kotlin, Scala, etc.) and most config languages (YAML, TOML, JSON, Dockerfile, SQL). Codexa doesn't parse syntax — it reads the diff as text — so it works on any source file.

How big a PR can Codexa review?

Diffs are capped at 60 KB before being sent to the AI. Larger PRs get truncated with a marker. This is a free-tier safety limit; on self-host you can raise it by editing backend/app/services/ai/prompt.py.

How long does a review take?

Typically 6–12 seconds end-to-end. Groq's Llama 3.3 returns in ~3 seconds; the remaining time is GitHub API round-trips and Supabase writes.

Will Codexa block my merge?

Only if you configure it to. By default, Codexa posts a check run that's either successful (if no error-severity findings) or failed (otherwise). Whether that blocks the merge depends on your branch protection settings — add the "Codexa AI Review" check as a required status check to enforce it.

Does Codexa store my code?

No. The PR diff is sent to the AI provider in real time and discarded immediately. Only the AI's summary and findings (file paths, line numbers, messages) are stored in our Supabase database.

Can I use Codexa on private repos?

Yes. The GitHub App requires only the permissions it needs — read access to contents and read/write access to pull requests. It works identically on public and private repos.

What happens if I uninstall the bot?

Codexa loses access to that repo immediately. No more reviews fire. Existing review records remain in the database (visible on the dashboard) — you can request deletion via the GitHub repo if you want them purged.

Codexa stopped posting status checks after I added the feature

Self-hosted Codexa: when you added the Checks API integration, you also had to update the GitHub App permission to Checks: Read and writeAND accept the new permission on each existing install. Go to GitHub → Settings → Applications → Installed GitHub Apps → click Configure on your app → look for the yellow "Review permissions" banner. See self-hosting → Updating GitHub App permissions for the full flow.

I want to contribute / report a bug

Codexa is open source. Open an issue or PR on the GitHub repo. Issues and pull requests are welcome.