grain

grain is a linter designed specifically for codebases using AI coding assistants. It flags common patterns in AI-generated code—like vague comments, broad exception handlers, and filler variable names—allowing developers to decide whether to keep, rewrite, or suppress each issue. The tool works alongside traditional linters like ruff and pylint, catching behavioral patterns they miss.

grain is built for both human review and automated repair workflows. It outputs structured JSON for agentic remediation, includes a worklog system to track multi-session repairs across large codebases, and supports custom rules via .grain.toml configuration. Install via pip and run grain check on specific files or entire repositories.