Agent Lint: open-source linter for Codex, AGENTS.md, MCP, Claude Code, and Cursor config #46874
zhupanov
started this conversation in
Show and tell
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
I’ve open-sourced Agent Lint, a linter for configuration used by Codex and other coding agents:
https://github.com/zhupanov/agent-lint
It validates things including:
.codex/ and .codex-plugin/
AGENTS.md
.agents/skills/
MCP configuration
Claude Code configuration
Cursor configuration
The project currently has ~300 lint rules, with a documented rule registry.
It supports configurable rule severity and suppression, running selected rules with --only, GitHub Actions integration, and prebuilt binaries for Linux and macOS. It’s implemented in Rust.
The motivation was pretty simple: agent configuration is becoming large and structured enough that it increasingly benefits from the same kind of automated validation we already expect for other parts of a software project.
I’d especially appreciate feedback from Codex users on:
configuration patterns I’m not covering yet
rules that would be useful for real-world Codex projects
false positives or cases where a rule is too opinionated
additional AGENTS.md or MCP checks worth adding
Issues and contributions are very welcome.
All reactions