PUBLISHED ON NPM - CODEXA CLI v1.0.0

Pre-commit guardrails that focus on the code you actually changed.

Codexa helps teams ship cleaner commits without punishing them for legacy noise. Run blame-aware checks, review issues in an interactive terminal UI, apply fast fixes, and keep your quality workflow local-first with optional Ollama suggestions.

npm install -g codexa-toolkit
Install from npm View on GitHub Read the docs

Interactive flow

From first setup to a clean commit in one terminal workflow.

Codexa is built for the place where quality checks usually break momentum: right before commit. The CLI installs into your repo, inspects staged files, separates pre-existing debt, and keeps the fix loop inside the terminal.

$ npm install -g codexa-toolkit

$ codexa init

Created codexa.config.json

Installed pre-commit hook

$ git commit -m "ship auth cleanup"

[MODERATE] src/auth.ts:32 no-unused-vars

Press [x] to apply fix or [n] to ask Ollama

Fix applied. Re-running checks...

Clean. Commit allowed.

Core capabilities

Everything the homepage should answer at a glance.

Blame-aware by default

Codexa classifies issues against the lines in your diff so teams can keep moving even when a repo still carries older lint debt.

Interactive fix loop

Use the terminal UI to inspect issues, apply supported fixes, and rerun checks without leaving the commit flow.

Solo and team workflows

Start in a single repository, then share policy with codexa.config.json, CI checks, dashboards, and reporting as adoption grows.

Local AI suggestions

When Ollama is available, Codexa can suggest fixes locally so teams can keep sensitive code and review context on their own machines.

Built-in language support

JavaScript, TypeScript, and Python are supported today, with an adapter model for expanding into more ecosystems over time.

Learning + history

Codexa keeps track of accepted fixes and run history so repeat issues become easier to understand and future workflows become more informed.

How it scales

Start solo, then tighten the loop for your team.

Area Solo usage Team usage
Primary use case Personal commit hygiene and local trends Shared policies, CI checks, and code quality visibility
Setup command codexa init codexa config init --team, then codexa init
Quality checks Blame-aware commit checks Blame-aware checks with CI enforcement options
Reporting history, report, and stats commands dashboard plus team-oriented reporting
Configuration Local repo defaults Repository-wide config files committed for teammates
Extensibility Adapters and optional Ollama assistance Same adapter model with shared adoption across repos

Get started

Install it once, then choose the workflow that matches your repo.

npm install -g codexa-toolkit
cd your-project
codexa init
git add .
git commit -m "first protected commit"
npm install -g codexa-toolkit
cd your-project
codexa config init --team
git add codexa.config.json .codexaignore
git commit -m "chore(codexa): add team policy"
codexa init

Product facts

  • Published package codexa-toolkit on npm
  • CLI command codexa
  • Built-in adapters JavaScript and Python today
  • Optional AI mode Local Ollama suggestions