brooks-lint — What is it?

brooks-lint is an AI-driven code review tool that diagnoses code decay risks using insights from classic engineering literature, providing actionable feedback and automated fixes.

⭐ 985 Stars 🍴 47 Forks JavaScript MIT Author: hyhmrright
Source: per README View on GitHub →

Why it matters

brooks-lint is gaining attention due to its unique approach to code reviews, addressing the pain points of inconsistent and incomplete feedback from traditional tools. Its integration with Claude Code and Gemini CLI, along with its deep analysis based on classic engineering books, sets it apart in the market.

Source: Synthesis of README and project traits

Core Features

Decay Risk Diagnostics

Evaluates code against six decay risk dimensions, providing structured findings with book citations, severity labels, and concrete remedies.

Source: per README
Analysis Modes

Supports six analysis modes, including full-sweep auto-fix, to address various code review needs.

Source: per README
Book Citations

Incorporates insights from twelve classic engineering books, providing context and depth to the code review process.

Source: per README

Architecture

The architecture of brooks-lint suggests a modular design with clear separation of concerns. It likely uses design patterns such as Dependency Injection for flexibility and maintainability. The code tree indicates a focus on CLI tools and integration with various platforms like Claude Code and Gemini CLI.

Source: Code tree + dependency files

Project Knowledge Graph

Knowledge graph: project (center) + core features (inner hexagons) + key dependencies (outer chips) @anthropic-ai/sdk@anthropic-ai/… Decay Risk DiagnosticsDecay Risk Diagnost… Analysis Modes Book Citations brooks-lint Project Core feature Key dependency

Center: project; inner ring: core feature modules; outer ring: key dependencies. Auto-generated from core_features and tech_stack.key_deps.

Tech Stack

LanguageJavaScriptFrameworkNot specified
@anthropic-ai/sdk
Not specified, but likely supports deployment on various platforms due to its integration with Claude Code and Gemini CLI.
Source: Dependency files + code tree

Quick Start

To install via Claude Code plugin marketplace: /plugin marketplace add hyhmrright/brooks-lint /plugin install brooks-lint@brooks-lint-marketplace To install manually: mkdir -p ~/.claude/skills/brooks-lint cp -r skills/* ~/.claude/skills/brooks-lint/ For Gemini CLI, use the extension installation command provided in the README.
Source: README Installation/Quick Start

Use Cases

brooks-lint is suitable for developers and teams looking to improve code quality and maintainability. It is useful in scenarios such as PR reviews, architecture audits, tech debt assessments, and test quality reviews.

Source: README

Strengths & Limitations

Strengths

  • Strength 1: Provides in-depth code analysis with actionable feedback.
  • Strength 2: Integrates with popular coding platforms like Claude Code and Gemini CLI.
  • Strength 3: Grounded in classic engineering literature for context and depth.

Limitations

  • Limitation 1: May have a steep learning curve due to its unique approach and features.
  • Limitation 2: Dependency on external platforms for full functionality.
Source: Synthesis of README, code structure and dependencies

Latest Release

v1.3.0 (2026-05-24): Added Codex marketplace icon and interface metadata. v1.2.3 (2026-05-13): Added script for version propagation. v1.2.2 (2026-04-29): Reduced skill token usage. v1.2.1 (2026-04-28): Fixed Codex CLI compatibility issue. v1.2.0 (2026-04-24): Introduced brooks-sweep with a sequential autonomous pipeline.

Source: GitHub Releases

Verdict

brooks-lint is a promising tool for developers and teams aiming to enhance code quality and maintainability through a unique, AI-driven approach. Its integration with existing coding platforms and its deep analysis capabilities make it a valuable asset for those looking to improve their codebase's health and longevity.

Frequently Asked Questions

What is brooks-lint?

brooks-lint is an AI-driven code review tool that diagnoses code decay risks using insights from classic engineering literature, providing actionable feedback and automated fixes.

What are the main features of brooks-lint?

brooks-lint's core features include: Decay Risk Diagnostics, Analysis Modes, Book Citations.

Why is brooks-lint trending?

brooks-lint is gaining attention due to its unique approach to code reviews, addressing the pain points of inconsistent and incomplete feedback from traditional tools.

What is brooks-lint used for?

brooks-lint is suitable for developers and teams looking to improve code quality and maintainability. It is useful in scenarios such as PR reviews, architecture audits, tech debt assessments, and test quality reviews.

Transparency Notice
This page is auto-generated by AI (a large language model) from the following public materials: GitHub README, code tree, dependency files and release notes. Analyzed at: 2026-06-08 18:30. Quality score: 85/100.

Data sources: README, GitHub API, dependency files