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

Help / Orange Codens

Orange Codens setup

Closed 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 is currently in Closed Beta. It's offered by invitation, primarily to organizations already using the Codens Suite (e.g. Red / Green). If you'd like access, contact your Codens account team.

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. Your organization must have Closed Beta access to Orange Codens (invitation-only; existing Red / Blue / Green / Purple users are prioritized).
  3. Admin / write access on the target GitHub repository.
  4. The Orange-specific GitHub App installed (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 during the Closed Beta. To confirm availability for your organization, check your review result comments or contact the account team.

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

Concrete monthly plan tiers are still in flux during the Closed Beta. Check with your Codens account team for current pricing.

Troubleshooting

Next steps