agentlint

Local guardrails for AI coding agents. Check proposed file changes and shell commands, block risky patterns, and return actionable feedback. Works with Claude C

What is agentlint?

Local guardrails for AI coding agents. Check proposed file changes and shell commands, block risky patterns, and return actionable feedback. Works with Claude Code, Codex, Cursor, Gemini CLI, and more

Overview of agentlint

What it is

AgentLint is a local guardrail tool for AI coding agents. It checks proposed file changes and shell commands, blocks risky patterns such as secret writes and plain force-pushes to main or master, and returns actionable feedback. It works with Claude Code, Codex, Cursor, Gemini CLI, and other agents.

Key features

  • Checks proposed file changes and shell commands locally before execution - Blocks detected secret writes, .env writes, plain force-pushes to main/master, CI pipeline edits, and package publishing - Warns about destructive commands, direct pushes to main, test weakening, and removed error handling - Includes 77 built-in rules in 8 packs: universal, quality, python, frontend, react, seo, security (opt-in), autopilot (opt-in, experimental)
  • Works with multiple coding agents via native hooks or adapters - Runs locally by default; no account or network connection required for offline rules - Licensed under MIT, open source

Use cases

  • Protect a shared branch while keeping normal Git work moving - Fix a legitimate action that keeps getting flagged (handle false positives)
  • Run Ruff, ESLint, or a formatter after agent edits - Apply a shared policy across repositories - Enforce a convention specific to your codebase with custom rules - Check pull request file changes in CI using agentlint ci

Getting started

Requires Python 3.11+ and pipx or uv. bash uv tool install agentlint cd your-project agentlint setup claude After setup, run agentlint status to verify hooks are running. If nothing is observed, run agentlint doctor. Alternatively, use pipx install agentlint instead of uv tool install agentlint.

License and pricing

Licensed under MIT. Open source. Pricing is not stated beyond open source.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/mauhpragentlint.svg)](https://yunodb.com/tools/mauhpragentlint?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/mauhpragentlint?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/mauhpragentlint.svg" alt="Featured on YunoDB" height="20"></a>