agnix
Health Pass
- License — License: Apache-2.0
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 134 GitHub stars
Code Pass
- Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
- Permissions — No dangerous permissions requested
This tool acts as a linter and language server protocol (LSP) for AI coding assistants. It validates and automatically fixes configuration files, hooks, and MCP settings to prevent AI agents from silently ignoring instructions due to syntax errors.
Security Assessment
The overall risk is rated as Low. The automated code scan reviewed 12 files and found no dangerous patterns, hardcoded secrets, or requests for dangerous permissions. Because it is designed to read and analyze local configuration files, it inherently accesses file paths on your system. However, the tool does not appear to execute arbitrary shell commands or make suspicious network requests based on the audit. As a standard precaution when using any new MCP server, you should monitor the specific file directories it is granted access to.
Quality Assessment
The project demonstrates excellent health and maintenance. It received a push update as recently as today, indicating active development by the maintainers. It has gathered 134 GitHub stars, showing a solid and growing level of community trust. Furthermore, the code is fully open-source under the highly permissive Apache-2.0 license, allowing for straightforward adoption, modification, and integration into professional workflows. The inclusion of official IDE plugins and a dedicated CI pipeline further highlights its stability.
Verdict
Safe to use. It is a well-maintained, strictly local utility that safely improves AI agent configurations without posing security risks.
The missing linter and lsp for AI coding assistants. Validate CLAUDE.md, AGENTS.md, SKILL.md, hooks, MCP. Plugin for all major IDEs included, with autofixes.
agnix
Lint agent configurations before they break your workflow
Catch broken agent configs before your AI tools silently ignore them.
385 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:
Why agnix?
Your skills don't trigger. Vercel's research found skills invoke at 0% without correct syntax. One wrong field and your skill is invisible.
"Almost right" is the worst outcome. 66% of developers cite it as their biggest AI frustration. Misconfigured agents produce exactly this.
Multi-tool stacks fail silently. Cursor + Claude Code + Copilot each want different formats. A config that works in one tool breaks in another.
Bad patterns get amplified. AI assistants don't ignore wrong configs - they learn from them.
agnix validates all of it - 385 rules sourced from official specs, academic research, and real-world breakage patterns. Auto-fix included.
Want to try it first? Open the playground - paste any agent config, see diagnostics instantly. No install, runs in your browser.
Quick Start
$ npx agnix .
Validating: .
CLAUDE.md:15:1 warning: Generic instruction 'Be helpful and accurate' [fixable]
help: Remove generic instructions. Claude already knows this.
.claude/skills/review/SKILL.md:3:1 error: Invalid name 'Review-Code' [fixable]
help: Use lowercase letters and hyphens only (e.g., 'code-review')
Found 1 error, 1 warning
2 issues are automatically fixable
hint: Run with --fix, --fix-safe, or --fix-unsafe to apply fixes
https://github.com/user-attachments/assets/72d5fe7c-476f-46ea-be64-5785cf6d5600
Install
# npm (recommended, all platforms)
npm install -g agnix
# Homebrew (macOS/Linux)
brew tap agent-sh/agnix && brew install agnix
# Cargo
cargo install agnix-cli
Pre-built binaries | All install options
Editor Extensions
| Editor | Install |
|---|---|
| VS Code | VS Code Marketplace |
| JetBrains | JetBrains Marketplace |
| Neovim | { "agent-sh/agnix", config = function() require("agnix").setup() end } |
| Zed | Search "agnix" in Extensions |
GitHub Action
- name: Validate agent configs
uses: agent-sh/agnix@v0
with:
target: 'claude-code'
Usage
agnix . # Validate current directory
agnix --fix . # Apply HIGH and MEDIUM confidence fixes
agnix --fix-safe . # Apply only HIGH confidence fixes
agnix --fix-unsafe . # Apply all fixes, including LOW confidence
agnix --dry-run --show-fixes . # Preview fixes with inline diff output
agnix --strict . # Strict mode (warnings = errors)
agnix --target claude-code . # Legacy target preset (primarily affects CC-* rules)
agnix --target kiro . # Legacy target preset (use tools = [...] for tool-only filtering)
Full CLI reference | Full rules reference
Supported Tools
| Tool | Rules | Count | Config Files |
|---|---|---|---|
| Agent Skills | AS-*, CC-SK-* | 31 | SKILL.md |
| Claude Code | CC-* | 53 | CLAUDE.md, hooks, agents, plugins |
| GitHub Copilot | COP-* | 6 | .github/copilot-instructions.md, .github/instructions/*.instructions.md |
| Cursor | CUR-* | 16 | .cursor/rules/*.mdc, .cursorrules, .cursor/hooks.json, .cursor/agents/**/*.md, .cursor/environment.json |
| Kiro | KIRO-*, KR-SK-*, KR-AG-*, KR-HK-*, KR-PW-*, KR-MCP-* | 51 | .kiro/steering/**/*.md, .kiro/skills/**/SKILL.md, .kiro/agents/*.json, .kiro/hooks/*.kiro.hook, .kiro/settings/mcp.json, .kiro/powers/*/POWER.md |
| MCP | MCP-* | 12 | *.mcp.json |
| AGENTS.md | AGM-*, XP-* | 13 | AGENTS.md, AGENTS.local.md, AGENTS.override.md |
| Cline | CLN-* | 4 | .clinerules, .clinerules/*.md, .clinerules/*.txt |
| Gemini CLI | GM-* | 9 | GEMINI.md, GEMINI.local.md, .gemini/settings.json (hooks), gemini-extension.json (extensions), .geminiignore |
Architecture
Rust workspace crates:
agnix-rules- rule metadata generated fromknowledge-base/rules.jsonagnix-core- shared validation engine libraryagnix-cli- command-line interface binaryagnix-lsp- language server binaryagnix-mcp- MCP server binaryagnix-wasm- WebAssembly bindings for browser/runtime integrations
Contributing
Contributions welcome. See CONTRIBUTING.md for the development guide.
Report a bug | Request a rule | Good first issues
License
MIT OR Apache-2.0
Star this repo to help other developers find agnix.
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found