简介

agnix 用于校验并修复 Agent 配置文件，避免 CLAUDE.md、skills、hooks、MCP 配置出错后被 AI 工具“静默忽略”。

最适合： 在多个仓库与工具之间共享 agent 配置的团队（Claude Code/Cursor/Codex/OpenCode）

适配： macOS/Linux/Windows；可用 npx/npm 运行；并提供编辑器集成（README）

配置时间： 3–10 分钟

关键事实（已验证）

• README 提到覆盖多工具/多文件类型的 421 条规则。
• README 的 Quick Start 为 npx agnix .。
• GitHub：239 stars · 20 forks；最近更新 2026-05-09（GitHub API 验证）。

正文

建议把 agnix 放到“提交前检查”里：

1. 在 CI 里对改动了 .claude/、CLAUDE.md、skills、hooks、MCP 配置的 PR 运行 agnix。
2. 自动修复只打开你能接受的范围；涉及权限收紧的变更建议强制人工 review。
3. 同时支持多工具时，用一份配置做单一事实来源，让 agnix 负责兼容性约束。

README 原文节选（verbatim）

agnix

Lint agent configurations before they break your workflow

Catch broken agent configs before your AI tools silently ignore them.
421 rules across Claude Code, Codex CLI, OpenCode, Cursor, Copilot, and more -
validating CLAUDE.md, SKILL.md, hooks, MCP configs, and other agent files.

Auto-fix | GitHub Action | VS Code + JetBrains + Neovim + Zed

New rules and tool support ship constantly. Follow for real-time updates:

FAQ

只支持 Claude Code 吗？ 答：README 列出更广的支持范围（Claude Code、Codex、OpenCode、Cursor、Copilot 等）。

不安装能跑吗？ 答：可以，README 给出 npx agnix .。

怎么接编辑器？ 答：README 提供编辑器扩展与 editor integration 指引。