agnix

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.

Stars: 60

Visit
 screenshot

Agnix is a tool designed to validate agent configurations before they disrupt your workflow. It offers 230 rules to check various agent files like CLAUDE.md, SKILL.md, hooks, and MCP configs. The tool aims to prevent AI tools from ignoring misconfigured agents by catching errors early. Agnix provides auto-fix functionality and supports multiple tools like Claude Code, Codex CLI, OpenCode, Cursor, and Copilot. It constantly updates its rules and tool support to ensure accurate validation of agent configurations.

README:

agnix

agnix

Lint agent configurations before they break your workflow

npm Crates.io Release CI License

Catch broken agent configs before your AI tools silently ignore them.
230 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

Website Playground Blog Post

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

Follow on X

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 - 230 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.nvim" }
Zed Search "agnix" in Extensions

Editor setup guide

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 .  # Target specific tool

Full CLI reference | All 230 rules

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
MCP MCP-* 12 *.mcp.json
AGENTS.md AGM-*, XP-* 13 AGENTS.md, AGENTS.local.md, AGENTS.override.md
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 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.

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for agnix

Similar Open Source Tools

For similar tasks

For similar jobs