CODEXA

AI pre-commit guardian. Blame-aware. Auto-fix. Learns your codebase.

Record with VHS or asciinema and convert to GIF. Recommended flow: codexa init -> git commit -> TUI -> [x] fix -> clean commit.

Why Codexa

• Blame-aware: only your errors block commits. Pre-existing issues are visible, never blocking.
• Auto-fix: one keypress applies applicable fixes. Fewer context switches, fewer bypasses.
• Learns: .codexa/patterns.json remembers accepted fixes and prioritizes them next time.

Quick Start - Solo

npm install -g codexa-toolkit
cd your-project
codexa init
git add . && git commit -m "first protected commit"

Quick Start - Team

# Each contributor
npm install -g codexa-toolkit

# Team lead (one time)
codexa config init --team
git add codexa.config.json .codexaignore
git commit -m "add codexa team config"

# Team members
codexa init

Features

| Feature | Solo | Team | | --- | --- | --- | | Blame-aware linting | Y | Y | | Interactive TUI | Y | Y | | Auto-fix [x] | Y | Y | | AI suggestions (Ollama) | Y | Y | | .codexa/ learning folder | Y | Y (shared) | | Clean commit streak | Y | - | | codexa report + sparklines | Y | - | | Weekly digest | Y | - | | Shared team config | - | Y | | GitHub Actions CI | - | Y | | Team dashboard | - | Y | | Hotspot detection | - | Y | | Plugin system | Y | Y |

Supported Languages

• Built-in: JavaScript, TypeScript, Python
• Community adapters:

codexa add-language codexa-adapter-go

Configuration

Minimal codexa.config.json:

{
  "version": 2,
  "blameMode": "strict",
  "languages": ["auto"],
  "severity": {
    "block": ["CRITICAL"],
    "warn": ["MODERATE"],
    "log": ["MINOR"],
    "overrides": {
      "no-console": "MODERATE"
    }
  },
  "ignore": ["dist", "build", "node_modules"],
  "team": {
    "name": "Engineering",
    "enforceOnCI": true,
    "blockThreshold": 1
  },
  "ci": {
    "outputFormat": "json",
    "failOn": "CRITICAL",
    "badge": true
  }
}

Full reference: docs/configuration.md

Requirements

• Node.js >= 18
• Git >= 2.0
• Python + ruff (for Python repos)
• Ollama (optional, for AI suggestions)

Contributing

• Contribution guide: CONTRIBUTING.md
• Adapter template: templates/adapter-template/
• Plugin authoring docs: docs/plugin-authoring.md

License

MIT