CLI

Install

# macOS
brew install codexax/tap/codexax

# Linux / macOS (manual)
curl -fsSL https://codexax.com/install.sh | sh

# npm (cross-platform)
npm i -g @codexax/cli

Sign in

Reuses your editor session if you have one; otherwise pops a browser:

codexax login

Common commands

codexax                      # interactive REPL
codexax "fix the test in src/foo.test.ts"
codexax review HEAD~5..HEAD  # AI review of recent commits
codexax explain <file>       # one-shot file explanation
codexax skill run review     # run a saved skill
codexax usage                # current month's spend
codexax keys list            # list API keys
codexax keys create my-ci    # mint a new key

CI usage

Set CODEXAX_API_KEY as a CI secret. Then:

# .github/workflows/review.yml
- run: |
    codexax review ${{ github.event.pull_request.base.sha }}..HEAD \
      --format=github-comment > review.md
    gh pr comment ${{ github.event.pull_request.number }} -F review.md

Output formats

• --format=text (default) — pretty terminal output.
• --format=json — machine-readable.
• --format=github-comment — markdown ready for gh pr comment.
• --format=sarif — for security scanners.