Help home Getting Started MCP setup Purple Red Blue Green Orange Auth Use cases Tools Errors Pricing Troubleshooting

Help / Orange Codens

Orange Codens setup

Beta

AI code review & security audit. An LLM automatically reviews GitHub PR diffs, then hands code-quality and security findings off to Purple / Red to produce an actual fix PR.

Orange Codens can be started just by installing the GitHub App. Sign up for a Codens account, install the "Orange Codens" GitHub App on the target repository, and automatic reviews start running the next time a PR is opened (see Step 1 below).

Overview

Orange Codens is an automated code review and security audit agent for GitHub Pull Requests. It creates a review run on every PR open / synchronize event and runs two review tracks in parallel.

Results are posted to the PR as one summary comment plus a small number of high-severity inline comments (up to 5). Unlike bots that only "flag" issues, Orange can automatically hand findings off to Purple / Red to produce an actual fix PR (whether handoff fires depends on the handoff policy — see below).

Prerequisites

  1. A Codens account and organization (auth.codens.ai).
  2. Admin / write access on the target GitHub repository.
  3. The Orange-specific GitHub App "Orange Codens" installed (install from https://github.com/apps/orange-codens/installations/new; permissions: Pull requests read & write, Checks write, Contents read, Metadata read — write access is required to post PR comments).

Orange is not currently part of codens-mcp's action-dispatch tools (the 38-tool catalog). Project creation and repository connection happen through the dashboard (app.orange.codens.ai) and GitHub.

Step 1. Create a project & connect a repository

  1. Log in to the dashboard (app.orange.codens.ai) via auth.codens.ai.
  2. Choose "New Project" and pick the GitHub repository you want reviewed.
  3. If the GitHub App isn't installed yet, you'll be guided through the install flow. Check the requested permissions (PR read & write / checks write / contents read / metadata read) and authorize.
  4. Once connected, a review run starts automatically on every PR open / synchronize event for that repository — no further setup is needed.
  5. Optionally configure the Handoff Policy and Rule Set (see "Finding handoff" below).

To re-run a review without pushing a new commit, you can also trigger it manually via the REST API.

POST /api/v1/review-runs { "pr_url": "https://github.com/Corevice/your-repo/pull/123", "organization_id": "..." }

How to read a review

Security review

The Security Module runs three sub-modules in parallel.

Dedup within a single review run uses a fingerprint of rule_id + file_path + start_line. If the same finding is still unresolved across commits, it updates the existing finding instead of creating a new one. Any rule_id listed in rule_set.disabled_rules is fully suppressed.

Finding handoff

Handoff is being enabled progressively, organization by organization. To confirm availability for your organization, check your review result comments.

Each finding's category determines its default handoff target.

HandoffPolicy.mode has four levels, and the default depends on plan tier.

Code-quality findings are opt-in on every tier (by design, so credit isn't auto-consumed without consent).

Handoff is merge-gated. Orange reviews PRs before they're merged, but the fix PRs Purple / Red produce are based on main / develop. If handoff fired while the original PR were still unmerged, the code it targets wouldn't exist on main yet. So auto-handoff only fires once the PR is merged. If someone clicks "request fix" under manual_only before merge, the request is queued; if the PR is closed without merging, the queued request is discarded.

To prevent infinite loops, PRs authored by a Codens bot (the Purple / Red GitHub App user) are still reviewed but excluded from auto-handoff (manual handoff is still possible). Review runs triggered as a Purple verify pass always have auto-handoff disabled.

Billing

See the Pricing page for current plan details.

Troubleshooting

Next steps