# read-only-auditor

read-only-auditor — a security audit subagent that cannot touch your files. Hooks in its frontmatter block Write, Edit, and Bash for the whole session.

- subagent · `type=agent` · Claude Code, Codex, Cursor · 434 installs
- Author: davila7
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/security/read-only-auditor.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/read-only-auditor

## What it does

Most audit prompts rely on trust: you ask the model not to change anything and hope it complies. read-only-auditor takes a different path. PreToolUse hooks reject Write, Edit, and Bash calls before they run, so the read-only guarantee is enforced by the system.

Coverage includes hardcoded credentials, SQL injection through raw queries, XSS, path traversal, permissive CORS, and debug endpoints left in production config. For each finding it records the file path, line number, vulnerability class, and severity from Critical down to Low. Fixes are described in prose, never applied to the code.

It uses only Read, Grep, and Glob, with the sonnet model. The report ends with a table sorted by severity and a note that no files were modified.

Installation drops `.claude/agents/read-only-auditor.md` into your project. For PCI-DSS reviews of payment code or pre-merge audits, the guarantee being mechanical rather than conversational matters.

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --agent security/read-only-auditor
```

2. **Manually: put the files in place**
- File: `.claude/agents/read-only-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/read-only-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/read-only-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/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/security/read-only-auditor.md

## When to use it
- Run a security audit that cannot alter the codebase
- Check payment processing code for PCI-DSS issues safely
- Find hardcoded secrets and JWT misconfigurations
- Produce a severity-ranked report for each finding
- Audit a branch before merge without touching it

## Example prompts
- Audit `src/payments/` for PCI-DSS compliance, do not change anything
- Review `src/auth/` for hardcoded secrets and JWT problems
- Run a read-only audit of `app/` before merging to main

## Similar
- [read-only-local-mysql-mcp-server](https://affpapa.org/en/nevibecode/mcp/read-only-local-mysql-mcp-server.md) — MCP server · ★ 7 repo stars
- [read-only-local-postgres-mcp-server](https://affpapa.org/en/nevibecode/mcp/read-only-local-postgres-mcp-server.md) — MCP server · ★ 2 repo stars
- [security-auditor](https://affpapa.org/en/nevibecode/skills/security-auditor.md) — skill · 1100 installs
- [symfony-security-auditor](https://affpapa.org/en/nevibecode/skills/symfony-security-auditor.md) — skill · 239 installs
- [ponder-auditor](https://affpapa.org/en/nevibecode/agents/ponder-auditor.md) — subagent · ★ 26718 repo stars
- [compliance-auditor](https://affpapa.org/en/nevibecode/agents/voltagent-compliance-auditor.md) — subagent · ★ 6505 repo stars

From the same set: [davila7/claude-code-templates](https://affpapa.org/en/nevibecode/by/davila7/claude-code-templates.md) — 745 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
