IrtezaAsadRizvi/claude-human-review

README preview

# claude-human-review

[![Claude Code Plugin](https://img.shields.io/badge/Claude%20Code-Plugin-D97757?logo=anthropic&logoColor=white)](https://docs.claude.com/en/docs/claude-code)
[![Python 3.9+](https://img.shields.io/badge/python-3.9%2B-blue?logo=python&logoColor=white)](https://www.python.org/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](#license)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](#contributing)
[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux-lightgrey)](#requirements)
[![GitHub stars](https://img.shields.io/github/stars/IrtezaAsadRizvi/claude-human-review?style=social)](https://github.com/IrtezaAsadRizvi/claude-human-review/stargazers)

A plugin that helps you actually understand the code Claude Code writes for you. After every turn that edits files, Claude pauses, drops short doc comments on the classes and functions it touched (JSDoc for TS/JS, docstrings for Python, and so on), then explains what changed and why in plain English. You either approve the changes or undo them. The review itself is tuned to stay short so the token cost is minimal.

**Keywords:** claude code review, claude code approval, approve claude changes, undo claude changes, AI code review, human-in-the-loop, claude code plugin, claude code hooks.

---

## Features

- **Stop-hook gate**: blocks Claude from ending any turn that edited files until a review is shown.
- **Plain-English review**: 60 to 120 words covering what changed, why, and any hidden risks.
- **Inline doc comments**: drops one-line JSDoc, docstrings, `//`, etc. on new or changed classes and functions, and skips trivial helpers and tests.

View full repository on GitHub →