{
  "markdown": "<div align=\"center\">\n  <img src=\"editors/vscode/icon.png\" alt=\"agnix\" width=\"128\">\n  <h1>agnix</h1>\n  <p><strong>Lint agent configurations before they break your workflow</strong></p>\n  <p>\n    <a href=\"https://www.npmjs.com/package/agnix\"><img src=\"https://img.shields.io/npm/v/agnix.svg?color=3C873A\" alt=\"npm\"></a>\n    <a href=\"https://crates.io/crates/agnix-cli\"><img src=\"https://img.shields.io/crates/v/agnix-cli.svg?color=E57324\" alt=\"Crates.io\"></a>\n    <a href=\"https://github.com/agent-sh/agnix/releases\"><img src=\"https://img.shields.io/github/v/release/agent-sh/agnix?color=0A7E8C\" alt=\"Release\"></a>\n    <a href=\"https://github.com/agent-sh/agnix/actions/workflows/ci.yml\"><img src=\"https://github.com/agent-sh/agnix/actions/workflows/ci.yml/badge.svg\" alt=\"CI\"></a>\n    <a href=\"LICENSE-MIT\"><img src=\"https://img.shields.io/badge/license-MIT%2FApache--2.0-64748B.svg\" alt=\"License\"></a>\n    <a href=\"https://github.com/hesreallyhim/awesome-claude-code\"><img src=\"https://awesome.re/mentioned-badge.svg\" alt=\"Mentioned in Awesome Claude Code\"></a>\n  </p>\n</div>\n\n> ⚡ Running this agent 24/7? [**tiyuvta inference**](https://inference.tiyuvta.ai) — hosted LLM inference built for always-on agents, OpenAI/Anthropic-compatible APIs.\n\n<p align=\"center\">Catch broken agent configs before your AI tools silently ignore them.<br>455 rules across Claude Code, Codex CLI, OpenCode, Cursor, Copilot, and more -<br>validating CLAUDE.md, SKILL.md, hooks, MCP configs, and other agent files.</p>\n\n<p align=\"center\"><strong>Auto-fix</strong> | <strong><a href=\"https://github.com/marketplace/actions/agnix-ci\">GitHub Action</a></strong> | <strong><a href=\"https://marketplace.visualstudio.com/items?itemName=avifenesh.agnix\">VS Code</a> + <a href=\"https://plugins.jetbrains.com/plugin/30087-agnix\">JetBrains</a> + <a href=\"https://github.com/agent-sh/agnix.nvim\">Neovim</a> + <a href=\"https://zed.dev/extensions?query=agnix\">Zed</a></strong></p>\n\n<p align=\"center\">\n  <a href=\"https://agent-sh.github.io/agnix/\"><img src=\"https://img.shields.io/badge/Docs-Website-2563EB?style=for-the-badge\" alt=\"Website\"></a>\n  <a href=\"https://agent-sh.github.io/agnix/playground\"><img src=\"https://img.shields.io/badge/Try_it-Playground-E91E63?style=for-the-badge\" alt=\"Playground\"></a>\n  <a href=\"https://dev.to/avifenesh/your-ai-agent-configs-are-probably-broken-and-you-dont-know-it-16n1\"><img src=\"https://img.shields.io/badge/Blog-Post-0A0A0A?style=for-the-badge&logo=dev.to\" alt=\"Blog Post\"></a>\n</p>\n\n<p align=\"center\"><em>New rules and tool support ship constantly. Follow for real-time updates:</em></p>\n<p align=\"center\">\n  <a href=\"https://x.com/avi_fenesh\"><img src=\"https://img.shields.io/badge/Follow-@avi__fenesh-1DA1F2?style=for-the-badge&logo=x&logoColor=white\" alt=\"Follow on X\"></a>\n</p>\n\n## Why agnix?\n\n**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.\n\n**\"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.\n\n**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).\n\n**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).\n\nagnix validates all of it - 455 rules sourced from official specs, academic research, and real-world breakage patterns. Auto-fix included.\n\n> **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.\n\n## Quick Start\n\n```console\n$ npx agnix .\nValidating: .\n\nCLAUDE.md:15:1 warning: Generic instruction 'Be helpful and accurate' [fixable]\n  help: Remove generic instructions. Claude already knows this.\n\n.claude/skills/review/SKILL.md:3:1 error: Invalid name 'Review-Code' [fixable]\n  help: Use lowercase letters and hyphens only (e.g., 'code-review')\n\nFound 1 error, 1 warning\n  2 issues are automatically fixable\n\nhint: Run with --fix, --fix-safe, or --fix-unsafe to apply fixes\n```\n\nhttps://github.com/user-attachments/assets/72d5fe7c-476f-46ea-be64-5785cf6d5600\n\n## Install\n\n```bash\n# npm (recommended, all platforms)\nnpm install -g agnix\n\n# Homebrew (macOS/Linux)\nbrew tap agent-sh/agnix && brew install agnix\n\n# pip (or `uvx agnix .` to run without installing)\npip install agnix\n\n# Cargo\ncargo install agnix-cli\n```\n\n[Pre-built binaries](https://github.com/agent-sh/agnix/releases) | [All install options](https://agent-sh.github.io/agnix/docs/installation)\n\n### Editor Extensions\n\n| Editor | Install |\n|--------|---------|\n| **VS Code** | [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=avifenesh.agnix) |\n| **JetBrains** | [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/30087-agnix) |\n| **Neovim** | `{ \"agent-sh/agnix\", config = function() require(\"agnix\").setup() end }` |\n| **Zed** | Search \"agnix\" in Extensions |\n\n[Editor setup guide](https://agent-sh.github.io/agnix/docs/editor-integration)\n\n### GitHub Action\n\n```yaml\n- name: Validate agent configs\n  uses: agent-sh/agnix@v0\n  with:\n    target: 'claude-code'\n```\n\n## Usage\n\n```bash\nagnix .              # Validate current directory\nagnix --fix .        # Apply only safe fixes\nagnix --fix-safe .   # Explicit safe-only fix mode\nagnix --fix-unsafe . # Apply all fixes, including medium and LOW confidence\nagnix --dry-run --show-fixes .  # Preview fixes with inline diff output\nagnix --strict .     # Strict mode (warnings = errors)\nagnix --format github .  # GitHub Actions annotations\nagnix explain MCP-018    # Explain a rule and its evidence\nagnix --target claude-code .  # Legacy target preset (primarily affects CC-* rules)\nagnix --target kiro .         # Legacy target preset (use tools = [...] for tool-only filtering)\n```\n\n[Full CLI reference](https://agent-sh.github.io/agnix/docs/configuration) | [Full rules reference](https://agent-sh.github.io/agnix/docs/rules)\n\n## Supported Tools\n\n| Tool | Rules | Count | Config Files |\n|------|-------|-------|--------------|\n| [Agent Skills](https://agentskills.io) | AS-\\*, CC-SK-\\* | 31 | SKILL.md |\n| [Claude Code](https://docs.anthropic.com/en/docs/build-with-claude/claude-code) | CC-\\* | 53 | CLAUDE.md, hooks, agents, plugins |\n| [GitHub Copilot](https://docs.github.com/en/copilot) | COP-\\* | 6 | .github/copilot-instructions.md, .github/instructions/\\*.instructions.md |\n| [Cursor](https://cursor.com) | CUR-\\* | 16 | .cursor/rules/\\*.mdc, .cursorrules, .cursor/hooks.json, .cursor/agents/\\*\\*/\\*.md, .cursor/environment.json |\n| [Kiro](https://kiro.dev) | KIRO-\\*, KR-SK-\\*, KR-AG-\\*, KR-HK-\\*, KR-PW-\\*, KR-MCP-\\* | 53 | .kiro/steering/\\*\\*/\\*.md, .kiro/skills/\\*\\*/SKILL.md, .kiro/agents/\\*\\*/\\*.{json,md}, .kiro/hooks/\\*.kiro.hook, .kiro/settings/mcp.json, .kiro/powers/\\*/POWER.md |\n| [MCP](https://modelcontextprotocol.io) | MCP-\\* | 12 | \\*.mcp.json |\n| [AGENTS.md](https://agentsmd.org) | AGM-\\*, XP-\\* | 13 | AGENTS.md, AGENTS.local.md, AGENTS.override.md |\n| [Cline](https://docs.cline.bot) | CLN-\\* | 4 | .clinerules, .clinerules/\\*.md, .clinerules/\\*.txt |\n| [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 |\n\n## Architecture\n\nRust workspace crates:\n- `agnix-rules` - rule metadata generated from `knowledge-base/rules.json`\n- `agnix-core` - shared validation engine library\n- `agnix-cli` - command-line interface binary\n- `agnix-lsp` - language server binary\n- `agnix-mcp` - MCP server binary\n- `agnix-wasm` - WebAssembly bindings for browser/runtime integrations\n\n## Contributing\n\nContributions welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for the development guide.\n\n[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)\n\n## License\n\nMIT OR Apache-2.0\n\n---\n\n<p align=\"center\">\n  <a href=\"https://github.com/agent-sh/agnix/stargazers\">Star this repo</a> to help other developers find agnix.\n</p>\n",
  "bytes": 8543,
  "sha": "2a27909cd8a15302638d90cd734249a3b741f104da447ae35267a6a01f2a7a16",
  "repo_slug": "agent-sh/agnix",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_agent_sh_agnix_agnix_51863fc7/readme"
}