Documentation Index
Fetch the complete documentation index at: https://docs.codeant.ai/llms.txt
Use this file to discover all available pages before exploring further.
Integrate CodeAnt AI directly into Claude Code to resolve PR review comments, review local changes, and generate custom review rules — all without leaving your terminal.
Video Walkthrough
What You Get
| Slash Command | Description |
|---|
/codeant:resolve-pr-comments | Fetch unresolved CodeAnt review comments on a PR and fix them |
/codeant:review-local | Run a CodeAnt code review on local changes and fix all issues |
/codeant:implement-repo-learnings | Learn team review patterns from PR history and generate custom rules in .codeant/review.json |
Prerequisites
-
Claude Code v2.0.73 or later — plugin support requires this minimum version (installation guide)
-
CodeAnt CLI installed and authenticated — follow the CLI setup guide
Installation
Install the CodeAnt plugin from inside Claude Code:
- Run
/plugin and select Manage plugins
- Choose Add plugin and enter the plugin registry URL:
https://github.com/CodeAnt-AI/skills
- Go to Install plugin, search for CodeAnt, and install it
- Restart Claude Code for the plugin to take effect
Usage
Fetch all unresolved CodeAnt AI review comments on a pull request and fix them.
With a PR number:
> /codeant:resolve-pr-comments 42
Auto-detect from current branch:
> /codeant:resolve-pr-comments
When auto-detecting, Claude Code will:
- Get your current branch name
- Run
codeant pr list --source-branch "<branch>" --state open to find the matching PR
- If multiple PRs match, ask you which one to use
The fix flow:
- Fetch comments — runs
codeant pr comments --pr-number <N> --codeant-generated true and filters to unresolved comments
- Categorize — separates inline code comments (actionable) from general PR-level comments (informational, skipped)
- Analyze and assign verdicts — for each inline comment:
- Reads the file with 30 lines of surrounding context
- Checks the code at the referenced line still matches what the comment describes
- Extracts code suggestions from the comment body
- Validates syntax, variable scope, imports, and that existing logic is not broken
- Assigns a verdict: ACCEPT, LIKELY ACCEPT, DO NOT ACCEPT, or STALE
- Present summary — shows all comments grouped by verdict with before/after code diffs
- Apply safe fixes — applies ACCEPT fixes, asks about LIKELY ACCEPT, skips DO NOT ACCEPT and STALE
- Resolve threads — marks applied comments as resolved on the PR via
codeant pr resolve (supports GitHub, GitLab, Bitbucket, and Azure DevOps)
- Offer to commit — lists changed files and offers to commit and push
Changes are not committed automatically — you review the diffs and decide.
/codeant:review-local — Review and Fix Local Changes
Run a CodeAnt AI code review on your local changes and fix all issues found.
You can specify the review scope:
> /codeant:review-local staged files only
> /codeant:review-local last commit
> /codeant:review-local against the develop branch
The skill selects the right flag based on your request:
| You say | Flag used |
|---|
| ”staged” | --staged |
| ”uncommitted” / nothing specific | --uncommitted (default) |
| “last commit” | --last-commit |
| ”last 3 commits” | --last-n-commits 3 |
| ”unpushed” / “committed” | --committed |
| a branch name | --base <branch> |
| a commit hash | --base-commit <hash> |
| ”everything” / “all” | --all |
The fix flow:
- Run review — executes
codeant review <scope-flag>
- Present findings — shows issues grouped by file with category labels (Security, Code Quality, Performance, Maintainability)
- Analyze and assign verdicts — classifies each issue as ACCEPT, LIKELY ACCEPT, DO NOT ACCEPT, or STALE
- Apply safe fixes — minimal changes only, skips anything that could break existing logic
- Verify — re-runs the review to confirm fixes are clean
- Report — initial findings, fixes applied, fixes skipped (and why), and verification results
Changes are not committed automatically — you review the diffs and commit when ready.
/codeant:implement-repo-learnings — Generate Custom Review Rules
Analyze your team’s PR review history to generate custom CodeAnt review rules.
> /codeant:implement-repo-learnings
The workflow:
- Fetch PR history — retrieves the last 100 merged PRs
- Extract human feedback — fetches review comments, filters out bots and non-actionable replies
- Analyze bug-fix commits — mines git history for recurring fix patterns
- Read project guidelines — extracts conventions from
.cursorrules, CLAUDE.md, CONTRIBUTING.md, etc.
- Cluster patterns — groups feedback into rule candidates with confidence levels (HIGH/MEDIUM)
- Interactive confirmation — presents each rule with evidence for your approval
- Write rules — generates
.codeant/review.json with your approved rules
Rules are merged with any existing .codeant/review.json — nothing is overwritten without confirmation.
Verdict System
All fix workflows use a verdict system to classify each suggestion before applying:
| Verdict | Meaning | Action |
|---|
| ACCEPT | Safe to apply — fix is correct, localized, and won’t break anything | Applied automatically |
| LIKELY ACCEPT | Probably correct, but may affect callers or tests | Applied only with user confirmation |
| DO NOT ACCEPT | Could break logic — changes signatures, removes error handling, or over-refactors | Skipped with explanation |
| STALE | Code has changed since the review — comment no longer applies | Skipped with explanation |
Example Workflows
> /codeant:resolve-pr-comments
Found PR #42: "Add payment processing" (feature/payments → main)
6 unresolved CodeAnt comments:
ACCEPT — Safe to apply (3):
src/auth.ts:34 — SQL injection in login query
Fix: parameterize the query → safe, no API change
src/auth.ts:78 — Missing rate limiting
Fix: add rate limiting middleware → safe, additive only
src/api/users.ts:45 — Magic number should be a constant
Fix: extract to named constant → safe, no behavior change
LIKELY ACCEPT — Verify callers (1):
src/api/users.ts:12 — Unvalidated input
Fix: add validation → callers may depend on permissive behavior
DO NOT ACCEPT (0)
STALE (0)
I will apply the 3 ACCEPT fixes now. Want me to also apply
the LIKELY ACCEPT fix, or skip it for now?
> apply all
✓ Applied src/auth.ts:34 — parameterized the SQL query
✓ Applied src/auth.ts:78 — added rate limiting middleware
✓ Applied src/api/users.ts:45 — extracted magic number to constant
✓ Applied src/api/users.ts:12 — added input validation
Resolving applied comments on PR...
✓ 4 comments resolved
Changes ready for review. Would you like me to commit and push?
Review → Fix → Ship
> Implement the user authentication endpoint
(Claude implements the feature)
> /codeant:review-local
Found 3 issues:
Security: Missing input sanitization (src/auth.ts:15) — ACCEPT
Code Quality: Unused variable (src/auth.ts:8) — ACCEPT
Code Quality: Missing error handling (src/auth.ts:42) — ACCEPT
All 3 fixes applied. Verification passed — no remaining issues.
> git add -A && git commit -m "Add auth endpoint"
Updating the Plugin
To get the latest skills:
/plugin marketplace update CodeAnt-AI/skills
Troubleshooting
“codeant: command not found”
Ensure the CLI is installed globally:
npm install -g codeant-cli
codeant --version
“Not authenticated” or “Could not detect remote”
codeant login # CodeAnt API auth
codeant set-token github <your-token> # SCM auth for PR features
“Could not detect repo name”
Ensure you’re in a git repository with a remote:
git remote get-url origin
Plugin not appearing after install
Run /reload-plugins to refresh without restarting Claude Code.