{"id":45312640,"url":"https://github.com/agent-sh/agnix","last_synced_at":"2026-04-02T00:32:34.188Z","repository":{"id":335581037,"uuid":"1146336156","full_name":"agent-sh/agnix","owner":"agent-sh","description":"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.","archived":false,"fork":false,"pushed_at":"2026-03-26T22:44:16.000Z","size":64112,"stargazers_count":109,"open_issues_count":1,"forks_count":12,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-03-27T06:52:18.062Z","etag":null,"topics":["agent","ai","ai-agents","ai-coding-assistant","claude","cli","code-quality","codex","copilot","cursor","devtools","linter","llm","lsp","mcp","opencode","rust","skills","vscode","vscode-extension"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/agent-sh.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE-APACHE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":"audit.toml","citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-01-30T23:54:10.000Z","updated_at":"2026-03-26T22:44:16.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/agent-sh/agnix","commit_stats":null,"previous_names":["avifenesh/agnix","agent-sh/agnix"],"tags_count":35,"template":false,"template_full_name":null,"purl":"pkg:github/agent-sh/agnix","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agent-sh%2Fagnix","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agent-sh%2Fagnix/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agent-sh%2Fagnix/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agent-sh%2Fagnix/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/agent-sh","download_url":"https://codeload.github.com/agent-sh/agnix/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agent-sh%2Fagnix/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31293384,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T21:15:39.731Z","status":"ssl_error","status_checked_at":"2026-04-01T21:15:34.046Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","ai","ai-agents","ai-coding-assistant","claude","cli","code-quality","codex","copilot","cursor","devtools","linter","llm","lsp","mcp","opencode","rust","skills","vscode","vscode-extension"],"created_at":"2026-02-21T07:46:04.446Z","updated_at":"2026-04-02T00:32:34.161Z","avatar_url":"https://github.com/agent-sh.png","language":"Rust","readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"editors/vscode/icon.png\" alt=\"agnix\" width=\"128\"\u003e\n  \u003ch1\u003eagnix\u003c/h1\u003e\n  \u003cp\u003e\u003cstrong\u003eLint agent configurations before they break your workflow\u003c/strong\u003e\u003c/p\u003e\n  \u003cp\u003e\n    \u003ca href=\"https://www.npmjs.com/package/agnix\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/agnix.svg?color=3C873A\" alt=\"npm\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://crates.io/crates/agnix-cli\"\u003e\u003cimg src=\"https://img.shields.io/crates/v/agnix-cli.svg?color=E57324\" alt=\"Crates.io\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/agent-sh/agnix/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/agent-sh/agnix?color=0A7E8C\" alt=\"Release\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/agent-sh/agnix/actions/workflows/ci.yml\"\u003e\u003cimg src=\"https://github.com/agent-sh/agnix/actions/workflows/ci.yml/badge.svg\" alt=\"CI\"\u003e\u003c/a\u003e\n    \u003ca href=\"LICENSE-MIT\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-MIT%2FApache--2.0-64748B.svg\" alt=\"License\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/hesreallyhim/awesome-claude-code\"\u003e\u003cimg src=\"https://awesome.re/mentioned-badge.svg\" alt=\"Mentioned in Awesome Claude Code\"\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\u003cp align=\"center\"\u003eCatch broken agent configs before your AI tools silently ignore them.\u003cbr\u003e385 rules across Claude Code, Codex CLI, OpenCode, Cursor, Copilot, and more -\u003cbr\u003evalidating CLAUDE.md, SKILL.md, hooks, MCP configs, and other agent files.\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\u003cstrong\u003eAuto-fix\u003c/strong\u003e | \u003cstrong\u003e\u003ca href=\"https://github.com/marketplace/actions/agnix-ci\"\u003eGitHub Action\u003c/a\u003e\u003c/strong\u003e | \u003cstrong\u003e\u003ca href=\"https://marketplace.visualstudio.com/items?itemName=avifenesh.agnix\"\u003eVS Code\u003c/a\u003e + \u003ca href=\"https://plugins.jetbrains.com/plugin/30087-agnix\"\u003eJetBrains\u003c/a\u003e + \u003ca href=\"https://github.com/agent-sh/agnix.nvim\"\u003eNeovim\u003c/a\u003e + \u003ca href=\"https://zed.dev/extensions?query=agnix\"\u003eZed\u003c/a\u003e\u003c/strong\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://agent-sh.github.io/agnix/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Docs-Website-2563EB?style=for-the-badge\" alt=\"Website\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://agent-sh.github.io/agnix/playground\"\u003e\u003cimg src=\"https://img.shields.io/badge/Try_it-Playground-E91E63?style=for-the-badge\" alt=\"Playground\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://dev.to/avifenesh/your-ai-agent-configs-are-probably-broken-and-you-dont-know-it-16n1\"\u003e\u003cimg src=\"https://img.shields.io/badge/Blog-Post-0A0A0A?style=for-the-badge\u0026logo=dev.to\" alt=\"Blog Post\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\u003cem\u003eNew rules and tool support ship constantly. Follow for real-time updates:\u003c/em\u003e\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://x.com/avi_fenesh\"\u003e\u003cimg src=\"https://img.shields.io/badge/Follow-@avi__fenesh-1DA1F2?style=for-the-badge\u0026logo=x\u0026logoColor=white\" alt=\"Follow on X\"\u003e\u003c/a\u003e\n\u003c/p\u003e\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 - 385 rules sourced from official specs, academic research, and real-world breakage patterns. Auto-fix included.\n\n\u003e **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 \u0026\u0026 brew 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 HIGH and MEDIUM confidence fixes\nagnix --fix-safe .   # Apply only HIGH confidence fixes\nagnix --fix-unsafe . # Apply all fixes, including LOW confidence\nagnix --dry-run --show-fixes .  # Preview fixes with inline diff output\nagnix --strict .     # Strict mode (warnings = errors)\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-\\* | 51 | .kiro/steering/\\*\\*/\\*.md, .kiro/skills/\\*\\*/SKILL.md, .kiro/agents/\\*.json, .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\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/agent-sh/agnix/stargazers\"\u003eStar this repo\u003c/a\u003e to help other developers find agnix.\n\u003c/p\u003e\n","funding_links":[],"categories":["Command Details","Tooling 🧰"],"sub_categories":["/agnix","Config Managers"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagent-sh%2Fagnix","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fagent-sh%2Fagnix","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagent-sh%2Fagnix/lists"}