CodeMoot

A second opinion for AI-generated code. Claude Code + Codex CLI collaboration platform that brings debate, review, autofix, and consensus patterns to your development workflow.

CodeMoot bridges Claude and GPT so they work as partners — one plans, the other reviews, and together they build better code than either could alone.

Quick Start

# Install globally
npm install -g @codemoot/cli

# One-command setup: verifies codex, creates config, runs first review
codemoot start

# Or step by step:
codemoot doctor           # check prerequisites
codemoot init             # create .cowork.yml
codemoot review src/      # review code with GPT
codemoot fix src/         # autofix loop: review → fix → re-review

# Debate architecture with GPT
codemoot debate start "Should we use REST or GraphQL?"

# Ship with confidence
codemoot shipit --profile safe

Prerequisites

• Node.js >= 20
• Codex CLI installed (npm install -g @openai/codex)
• ChatGPT subscription (Codex CLI uses your existing subscription — $0 API cost)

Commands

Getting Started

Core Workflows

Multi-Model Debate

Automation

Background Jobs

Session Management

Observability

Review Presets

Shipit Profiles

Policy Engine

CodeMoot includes a built-in policy engine that gates actions:

• Block on CRITICAL: Any critical finding blocks the commit
• Warn on NEEDS_REVISION: Review verdict triggers a warning
• Custom rules via predicate-based engine (enforce/warn modes)

Architecture

TypeScript monorepo with 3 packages:

How It Works

1. Claude Code is your primary AI — it plans, writes code, manages your project
2. Codex CLI (GPT) acts as reviewer/critic — it reads your codebase, finds bugs, suggests fixes
3. CodeMoot bridges them — structured prompts, session persistence, token tracking, policy gates

All GPT calls happen via Codex CLI using your ChatGPT subscription — $0 API cost.

Configuration

.cowork.yml in your project root:

models:
  codex-architect:
    provider: openai
    model: gpt-5.3-codex
    providerMode: cli
  codex-reviewer:
    provider: openai
    model: gpt-5.3-codex
    providerMode: cli

roles:
  architect:
    model: codex-architect
  reviewer:
    model: codex-reviewer

workflow: plan-review-implement
mode: autonomous

.codemootignore

Exclude files from review/cleanup/watch (gitignore syntax):

node_modules
dist
*.db
.env

MCP Server (Experimental)

Add to your .mcp.json:

{
  "mcpServers": {
    "codemoot": {
      "command": "npx",
      "args": ["@codemoot/mcp-server"],
      "env": {
        "CODEMOOT_PROJECT_DIR": "/path/to/your/project"
      }
    }
  }
}

Tools: codemoot_review, codemoot_plan, codemoot_debate, codemoot_memory, codemoot_cost

Development

git clone https://github.com/katarmal-ram/codemoot.git
cd codemoot
pnpm install
pnpm build
pnpm test         # 624 tests across 47 files
pnpm lint         # Biome linter
pnpm typecheck    # TypeScript strict checks

Known Limitations

• Background job worker must be started manually (auto-spawn coming)
• Watch mode enqueues jobs but requires worker process
• MCP server is experimental — core + CLI are stable
• Autofix loop depends on GPT's ability to apply edits via Codex tools
• Windows path normalization may have edge cases

License

MIT