# Agnix > 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. - **Type:** MCP server - **Install:** `agentstack add mcp-agent-sh-agnix` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [agent-sh](https://agentstack.voostack.com/s/agent-sh) - **Installs:** 0 - **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools) - **Latest version:** 0.1.0 - **License:** Apache-2.0 - **Upstream author:** [agent-sh](https://github.com/agent-sh) - **Source:** https://github.com/agent-sh/agnix ## Install ```sh agentstack add mcp-agent-sh-agnix ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About agnix Lint agent configurations before they break your workflow Catch broken agent configs before your AI tools silently ignore them.432 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%](https://vercel.com/blog/agents-md-outperforms-skills-in-our-agent-evals) without correct syntax. One wrong field and your skill is invisible. **"Almost right" is the worst outcome.** [66% of developers](https://survey.stackoverflow.co/2025/ai) 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](https://arnav.tech/beyond-copilot-cursor-and-claude-code-the-unbundled-coding-ai-tools-stack). **Bad patterns get amplified.** AI assistants don't ignore wrong configs - they [learn from them](https://www.augmentcode.com/guides/enterprise-coding-standards-12-rules-for-ai-ready-teams). agnix validates all of it - 432 rules sourced from official specs, academic research, and real-world breakage patterns. Auto-fix included. > **Want to try it first?** [Open the playground](https://agent-sh.github.io/agnix/playground) - paste any agent config, see diagnostics instantly. No install, runs in your browser. ## Quick Start ```console $ 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 ```bash # 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](https://github.com/agent-sh/agnix/releases) | [All install options](https://agent-sh.github.io/agnix/docs/installation) ### Editor Extensions | Editor | Install | |--------|---------| | **VS Code** | [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=avifenesh.agnix) | | **JetBrains** | [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/30087-agnix) | | **Neovim** | `{ "agent-sh/agnix", config = function() require("agnix").setup() end }` | | **Zed** | Search "agnix" in Extensions | [Editor setup guide](https://agent-sh.github.io/agnix/docs/editor-integration) ### GitHub Action ```yaml - name: Validate agent configs uses: agent-sh/agnix@v0 with: target: 'claude-code' ``` ## Usage ```bash 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](https://agent-sh.github.io/agnix/docs/configuration) | [Full rules reference](https://agent-sh.github.io/agnix/docs/rules) ## Supported Tools | Tool | Rules | Count | Config Files | |------|-------|-------|--------------| | [Agent Skills](https://agentskills.io) | AS-\*, CC-SK-\* | 31 | SKILL.md | | [Claude Code](https://docs.anthropic.com/en/docs/build-with-claude/claude-code) | CC-\* | 53 | CLAUDE.md, hooks, agents, plugins | | [GitHub Copilot](https://docs.github.com/en/copilot) | COP-\* | 6 | .github/copilot-instructions.md, .github/instructions/\*.instructions.md | | [Cursor](https://cursor.com) | CUR-\* | 16 | .cursor/rules/\*.mdc, .cursorrules, .cursor/hooks.json, .cursor/agents/\*\*/\*.md, .cursor/environment.json | | [Kiro](https://kiro.dev) | KIRO-\*, KR-SK-\*, KR-AG-\*, KR-HK-\*, KR-PW-\*, KR-MCP-\* | 52 | .kiro/steering/\*\*/\*.md, .kiro/skills/\*\*/SKILL.md, .kiro/agents/\*.json, .kiro/hooks/\*.kiro.hook, .kiro/settings/mcp.json, .kiro/powers/\*/POWER.md | | [MCP](https://modelcontextprotocol.io) | MCP-\* | 12 | \*.mcp.json | | [AGENTS.md](https://agentsmd.org) | AGM-\*, XP-\* | 13 | AGENTS.md, AGENTS.local.md, AGENTS.override.md | | [Cline](https://docs.cline.bot) | CLN-\* | 4 | .clinerules, .clinerules/\*.md, .clinerules/\*.txt | | [Gemini CLI](https://github.com/google-gemini/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 from `knowledge-base/rules.json` - `agnix-core` - shared validation engine library - `agnix-cli` - command-line interface binary - `agnix-lsp` - language server binary - `agnix-mcp` - MCP server binary - `agnix-wasm` - WebAssembly bindings for browser/runtime integrations ## Contributing Contributions welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for the development guide. [Report a bug](https://github.com/agent-sh/agnix/issues/new) | [Request a rule](https://github.com/agent-sh/agnix/issues/new) | [Good first issues](https://github.com/agent-sh/agnix/labels/good%20first%20issue) ## License MIT OR Apache-2.0 --- Star this repo to help other developers find agnix. ## Source & license This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [agent-sh](https://github.com/agent-sh) - **Source:** [agent-sh/agnix](https://github.com/agent-sh/agnix) - **License:** Apache-2.0 Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/mcp-agent-sh-agnix - Seller: https://agentstack.voostack.com/s/agent-sh - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.