reviewd: Instructions file for Claude Code

CLAUDE.md

reviewd CLAUDE.md is an instructions file for Claude Code from simion/reviewd. It costs 881 tokens per session, scanned C, original, MIT.

A project instruction file describing the conventions, important files, dependencies, and release rules for the reviewd code-review daemon.

In plain words
What is it for?
Use it when working on reviewd, including its command-line interface, review process, configuration, storage, comments, tests, or releases.
Why use it?
It gives an agent the project-specific rules needed to modify or review that code consistently.

Instructions file for Claude Code

Written for Claude Code: the file is CLAUDE.md. Also seen: mentions CLAUDE.md; mentions Codex; mentions Gemini CLI.

This is simion/reviewd's own configuration. It tells Claude Code how to work on reviewd itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything reviewd configures →

Reuse

Borrowing it

Nothing to install: this file belongs to simion/reviewd. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/simion/reviewd/main/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/simion/reviewd

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for reviewd CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/simion/reviewd/claude-md/github.svg)](https://agentmods.dev/instructions/simion/reviewd/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/simion/reviewd/claude-md"><img src="https://agentmods.dev/badge/instructions/simion/reviewd/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for reviewd CLAUDE.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/simion/reviewd/claude-md"><img src="https://agentmods.dev/badge/instructions/simion/reviewd/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 881 This file is loaded in full into every session.
When invoked 881 The same file — it is already loaded in full.
Security scan C 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00881 $0.00881
Opus 5.5 $0.00352 $0.00352
Sonnet 5.5 $0.00176 $0.00176
Haiku 4.5 $0.00088 $0.00088

Measured 25d ago against content hash 8d7ee59f20a2, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade C, and why

reviewd CLAUDE.md scanned grade C with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 25d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Recursive force deletehighDestructive command

rm -rf with a variable or a broad path is one typo away from removing the wrong tree.

rm -rf dist && uv build && uv publish
CLAUDE.md · 58 lines

How it starts

The opening of the file, as written. The whole thing — 58 lines — stays where its author put it; the contents beside it link to each section on GitHub.

CLAUDE.md — reviewd

Local AI code review daemon for GitHub/GitLab/BitBucket PRs. See README.md for full docs.

Project Conventions

  • Python 3.12+, no backward compatibility
  • Dependencies managed with uv
  • Google style, single quotes for strings, double quotes for messages
  • No broad except clauses
  • No unnecessary docstrings or comments
  • Tests only when explicitly asked
  • Never add Co-Authored-By to commits
  • Only commit or release when explicitly asked

Key Files

File Purpose
src/reviewd/cli.py Click CLI: ls, watch, pr, status commands
src/reviewd/daemon.py Poll loop, boot summary, status line, orchestration, signal handling
src/reviewd/reviewer.py Worktree lifecycle + AI CLI invocation (Popen) + JSON extraction
src/reviewd/prompt.py Built-in review prompt template + builder
src/reviewd/commenter.py Format findings as markdown, post via provider, delete old comments by ID
src/reviewd/config.py YAML + ${ENV_VAR} loading, global + per-project merge, provider factory
src/reviewd/state.py SQLite: reviews + posted_comments (with get/delete by repo+PR)
src/reviewd/models.py Dataclasses: PRInfo, Finding, ReviewResult, configs, CLI enum
src/reviewd/providers/base.py Abstract GitProvider ABC
src/reviewd/providers/bitbucket.py BitBucket 2.0 API (httpx, pagination with ID dedup, inline comments)
src/reviewd/providers/github.py GitHub REST API v3 (httpx, Link header pagination, review comments)
src/reviewd/providers/gitlab.py GitLab REST API v4 (httpx, self-hosted url, MR notes + diff discussions)

Releasing

Publish directly to PyPI with uv publish. No GitHub Releases — gh CLI is not available.

Requires UV_PUBLISH_TOKEN env var (PyPI API token).

# 1. Bump version in pyproject.toml
# 2. Commit and push
git add pyproject.toml && git commit -m "Bump version to X.Y.Z" && git push
# 3. Clean old builds, build, and publish
rm -rf dist && uv build && uv publish

Read the full file on GitHub · 58 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 25d ago Changed · +2 lines · +83 tokens per session 8d7ee59f20a2
  2. 1mo ago First seen · 56 lines · 798 tokens per session scan C a3652972e5a4

Subscribe to this mod's changes

reviewd CLAUDE.md is an instructions file published in the GitHub repository simion/reviewd (70 stars, last pushed 26d ago), licensed MIT. It adds 881 tokens to every session, about $0.0035 per session on Opus 5.5. A static security scan graded it C with 1 finding (recursive force delete). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other instructions, from other repositories