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.