# code-auditor

code-auditor goes over the code you just changed, flags logic bugs, vague names and leftovers, then says in plain words what needs fixing.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 276 repo stars
- Author: Samarth Gupta
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-coding/agents/code-auditor.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/samarth-gupta-code-auditor

## What it does

code-auditor is a subagent for Claude aimed at code quality after a change: logic, clarity, naming, unused branches. It runs on sonnet with Read, Grep, Glob and Bash, and keeps project memory, so the conventions it picks up in your repo survive into the next run.

There are two modes. A quick question — is this function name any good, should this error be caught here — gets a short advisory answer whose first line is `Mode: Advisor`, with no report attached. Ask for a quality review, or let it fire after a diff, and the auditor takes over: it lists the files it read, gives a verdict, then works through error paths, boundary cases, nesting and stray debug lines. Dead-code hunts walk the import graph and label each hit as confirmed or as a candidate a human should look at.

Bash is read-only on purpose: `git diff`, `git log`, `tree`, `find -type f`, `wc -l`. Build and test commands are out of reach, so a fault that only appears at runtime will not turn up here. Security, speed and architecture sit outside the brief as well; it names the matching agent in one sentence and moves on.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add gupsammy/Claudest
```
In the agent chat (not a shell):
```text
/plugin install claude-coding@Claudest
```

2. **Manually: put the files in place**
- File: `.claude/agents/code-auditor.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/code-auditor.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/code-auditor.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-coding/agents/code-auditor.md

## When to use it
- review only the files a refactor touched
- find exports that nothing imports
- match new code to the project's naming and error-handling habits
- get a straight answer on one name or one `catch` block
- strip leftover debug prints and stale TODOs

## Example prompts
- Run code-auditor over the files from my last commit and tell me what to fix.
- Ask code-auditor if `parseInvoice` is the right name for this helper.
- Have code-auditor hunt for dead exports under `src/billing`.

## Similar
- [llm-artifacts-detection](https://affpapa.org/en/nevibecode/skills/llm-artifacts-detection.md) — skill · 151 installs
- [simplify](https://affpapa.org/en/nevibecode/skills/seifbenayed-simplify.md) — skill · ★ 116 repo stars
- [lsp-dead-code](https://affpapa.org/en/nevibecode/skills/lsp-dead-code.md) — skill · ★ 182 repo stars
- [refactor-safely](https://affpapa.org/en/nevibecode/skills/refactor-safely.md) — skill · 1200 installs
- [architecture-auditor](https://affpapa.org/en/nevibecode/agents/architecture-auditor.md) — subagent · ★ 1357 repo stars
- [unused-code-cleaner](https://affpapa.org/en/nevibecode/agents/unused-code-cleaner.md) — subagent · 1990 installs

## Other versions with the same name
- [code-auditor · 0xsteph](https://affpapa.org/en/nevibecode/agents/code-auditor.md) — ★ 2482 repo stars

From the same set: [gupsammy/claudest](https://affpapa.org/en/nevibecode/by/gupsammy/claudest.md) — 47 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
