> ## 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.

# Claude Code Integration

> Integrate CodeAnt AI code review and PR comment resolution into your Claude Code workflow

Integrate CodeAnt AI directly into [Claude Code](https://docs.anthropic.com/en/docs/claude-code) to resolve PR review comments, review local changes, and generate custom review rules — all without leaving your terminal.

## Video Walkthrough

<iframe src="https://www.tella.tv/video/vid_cmn207ls501ad04l720pn71l9/embed?b=1&title=1&a=1&loop=0&t=0&muted=0&wt=1&o=1" width="100%" height="400" frameBorder="0" allowFullScreen />

## 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

1. **Claude Code v2.0.73 or later** — plugin support requires this minimum version ([installation guide](https://docs.anthropic.com/en/docs/claude-code))

2. **CodeAnt CLI** installed and authenticated — follow the [CLI setup guide](https://docs.codeant.ai/cli/setup)

## Installation

Install the CodeAnt plugin from inside Claude Code:

1. Run `/plugin` and select **Manage plugins**
2. Choose **Add plugin** and enter the plugin registry URL:
   ```
   https://github.com/CodeAnt-AI/skills
   ```
3. Go to **Install plugin**, search for **CodeAnt**, and install it
4. Restart Claude Code for the plugin to take effect

## Usage

### `/codeant:resolve-pr-comments` — Resolve PR Review Comments

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:

1. Get your current branch name
2. Run `codeant pr list --source-branch "<branch>" --state open` to find the matching PR
3. If multiple PRs match, ask you which one to use

**The fix flow:**

1. **Fetch comments** — runs `codeant pr comments --pr-number <N> --codeant-generated true` and filters to unresolved comments
2. **Categorize** — separates inline code comments (actionable) from general PR-level comments (informational, skipped)
3. **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**
4. **Present summary** — shows all comments grouped by verdict with before/after code diffs
5. **Apply safe fixes** — applies ACCEPT fixes, asks about LIKELY ACCEPT, skips DO NOT ACCEPT and STALE
6. **Resolve threads** — marks applied comments as resolved on the PR via `codeant pr resolve` (supports GitHub, GitLab, Bitbucket, and Azure DevOps)
7. **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.

```
> /codeant:review-local
```

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:**

1. **Run review** — executes `codeant review <scope-flag>`
2. **Present findings** — shows issues grouped by file with category labels (Security, Code Quality, Performance, Maintainability)
3. **Analyze and assign verdicts** — classifies each issue as ACCEPT, LIKELY ACCEPT, DO NOT ACCEPT, or STALE
4. **Apply safe fixes** — minimal changes only, skips anything that could break existing logic
5. **Verify** — re-runs the review to confirm fixes are clean
6. **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:**

1. **Fetch PR history** — retrieves the last 100 merged PRs
2. **Extract human feedback** — fetches review comments, filters out bots and non-actionable replies
3. **Analyze bug-fix commits** — mines git history for recurring fix patterns
4. **Read project guidelines** — extracts conventions from `.cursorrules`, `CLAUDE.md`, `CONTRIBUTING.md`, etc.
5. **Cluster patterns** — groups feedback into rule candidates with confidence levels (HIGH/MEDIUM)
6. **Interactive confirmation** — presents each rule with evidence for your approval
7. **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

### Resolve PR Comments

```
> /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:

```bash theme={null}
npm install -g codeant-cli
codeant --version
```

**"Not authenticated" or "Could not detect remote"**

```bash theme={null}
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:

```bash theme={null}
git remote get-url origin
```

**Plugin not appearing after install**

Run `/reload-plugins` to refresh without restarting Claude Code.