Create an account

The Codens family shares a single authentication base called Auth Codens. One account signs you into Red, Blue, Green, Purple, and Yellow.

Open https://auth.codens.ai/en/signup.
Sign up with email + password, or use Google / GitHub SSO.
Confirm your email via the verification link.

New accounts get a Free Trial of 30,000 credits valid for 14 days. No credit card required. See Pricing for details.

2

Set up an organization

Codens manages billing and resources per organization. Even individual users need one organization.

Enter an organization name during signup (you can change it later).
Invite teammates as needed. Roles are Admin / Member.
Billing details can be added later from the Auth Codens billing page.

Each product has its own independent organization_id. SSO tokens are shared, but Red / Blue / Green / Purple each issue their own UUID. When using MCP, omit organization_id — it is resolved automatically.

3

Pick the products you need

Enable them as you go. You do not need all of them, and you can add more later.

Product	When to use	Setup
Purple	Hand AI a coding task and want a PR back	purple.html
Red	Auto-fix PRs from Sentry / bug reports	red.html
Blue	Generate and run E2E tests with AI	blue.html
Green	Turn ambiguous requirements into PRDs / Plans	green.html
Auth	SSO / API keys / organization management	auth.html

4

Set up MCP (recommended)

To call Codens directly from AI agents (Claude Code / Cursor / Cline / etc.), install codens-mcp. You can skip this if you only plan to use the dashboards — but agent-driven workflows shine through MCP.

# 1. Install
pip install codens-mcp

# 2. Register in ~/.claude/settings.json (Claude Code)
{
  "mcpServers": {
    "codens": { "command": "codens-mcp", "args": [] }
  }
}

# 3. Log in with Device Code Flow
codens-mcp login

See MCP setup for the full walkthrough, per-client examples, and troubleshooting.

5

Create your first project

Link a GitHub repository to each Codens product. The same repo can be registered to multiple products (one call via the unified register tool).

Option A. Via the dashboard. Each product (Red / Blue / Green / Purple): open "New Project", run GitHub OAuth, and pick a repo.

Option B. Via MCP (let the agent register everything at once):

// Register the same repo across four products in a single call
await tools.codens_register_project_unified({
  repo_full_name: "Corevice/your-repo",
  products: ["purple", "red", "blue", "green"]
});

Per-product settings (GitHub App install, Sentry webhook, Notion link, etc.) are covered in each product's setup page.

Getting Started