# agnix — Lint & Fix Agent Configs

> Lint and auto-fix agent config files (CLAUDE.md, SKILL.md, hooks, MCP configs) to catch broken setups before tools silently ignore them.

## Install

Copy the content below into your project:

## Quick Use

```bash
# Run without install (README)
npx agnix .

# Or install globally
npm install -g agnix
agnix .
```

## Intro

agnix validates and fixes agent configuration files so your AI tools don’t quietly ignore malformed CLAUDE.md, skills, hooks, and MCP configs.

**Best for:** Teams sharing agent configs across repos and tools (Claude Code/Cursor/Codex/OpenCode)

**Works with:** macOS/Linux/Windows; run via npx/npm; editor integrations are available (README)

**Setup time:** 3–10 minutes

### Key facts (verified)

- README mentions 421 rules spanning multiple agent tools and file types.
- Quick start is `npx agnix .` (README).
- GitHub: 239 stars · 20 forks; pushed 2026-05-09 (GitHub API verified).

## Main

Use agnix as a “pre-commit check” for agent files:

1) Run it in CI on PRs that touch `.claude/`, `CLAUDE.md`, skills, hooks, or MCP config files.
2) Enable auto-fix only for changes you’re comfortable with, and require review for permission-tightening edits.
3) If you support multiple tools, keep a single source of truth and let agnix enforce compatibility.


### README excerpt (verbatim)

<div align="center">
  <img src="editors/vscode/icon.png" alt="agnix" width="128">
  <h1>agnix</h1>
  <p><strong>Lint agent configurations before they break your workflow</strong></p>
  <p>
    <a href="https://www.npmjs.com/package/agnix"><img src="https://img.shields.io/npm/v/agnix.svg?color=3C873A" alt="npm"></a>
    <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>
    <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>
    <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>
    <a href="LICENSE-MIT"><img src="https://img.shields.io/badge/license-MIT%2FApache--2.0-64748B.svg" alt="License"></a>
    <a href="https://github.com/hesreallyhim/awesome-claude-code"><img src="https://awesome.re/mentioned-badge.svg" alt="Mentioned in Awesome Claude Code"></a>
  </p>
</div>

<p align="center">Catch broken agent configs before your AI tools silently ignore them.<br>421 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>

<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>

<p align="center">
  <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>
  <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>
  <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>
</p>

<p align="center"><em>New rules and tool support ship constantly. Follow for real-time updates:</em></p>
<p align="center">

### FAQ

**Q: Is it only for Claude Code?**
A: README lists broader tool support (Claude Code, Codex, OpenCode, Cursor, Copilot, etc.).

**Q: Can it run without installing?**
A: Yes—README shows `npx agnix .`.

**Q: How do I integrate with an editor?**
A: README points to editor extensions and an editor integration guide.

## Source & Thanks

> Source: https://github.com/agent-sh/agnix
> License: Apache-2.0
> GitHub stars: 239 · forks: 20

---

<!-- ZH -->

## 快速使用

```bash
# 免安装运行（README）
npx agnix .

# 或全局安装
npm install -g agnix
agnix .
```

## 简介

agnix 用于校验并修复 Agent 配置文件，避免 CLAUDE.md、skills、hooks、MCP 配置出错后被 AI 工具“静默忽略”。

**最适合：** 在多个仓库与工具之间共享 agent 配置的团队（Claude Code/Cursor/Codex/OpenCode）

**适配：** macOS/Linux/Windows；可用 npx/npm 运行；并提供编辑器集成（README）

**配置时间：** 3–10 分钟

### 关键事实（已验证）

- README 提到覆盖多工具/多文件类型的 421 条规则。
- README 的 Quick Start 为 `npx agnix .`。
- GitHub：239 stars · 20 forks；最近更新 2026-05-09（GitHub API 验证）。

## 正文

建议把 agnix 放到“提交前检查”里：

1) 在 CI 里对改动了 `.claude/`、`CLAUDE.md`、skills、hooks、MCP 配置的 PR 运行 agnix。
2) 自动修复只打开你能接受的范围；涉及权限收紧的变更建议强制人工 review。
3) 同时支持多工具时，用一份配置做单一事实来源，让 agnix 负责兼容性约束。


### README 原文节选（verbatim）

<div align="center">
  <img src="editors/vscode/icon.png" alt="agnix" width="128">
  <h1>agnix</h1>
  <p><strong>Lint agent configurations before they break your workflow</strong></p>
  <p>
    <a href="https://www.npmjs.com/package/agnix"><img src="https://img.shields.io/npm/v/agnix.svg?color=3C873A" alt="npm"></a>
    <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>
    <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>
    <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>
    <a href="LICENSE-MIT"><img src="https://img.shields.io/badge/license-MIT%2FApache--2.0-64748B.svg" alt="License"></a>
    <a href="https://github.com/hesreallyhim/awesome-claude-code"><img src="https://awesome.re/mentioned-badge.svg" alt="Mentioned in Awesome Claude Code"></a>
  </p>
</div>

<p align="center">Catch broken agent configs before your AI tools silently ignore them.<br>421 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>

<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>

<p align="center">
  <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>
  <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>
  <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>
</p>

<p align="center"><em>New rules and tool support ship constantly. Follow for real-time updates:</em></p>
<p align="center">

### FAQ

**只支持 Claude Code 吗？**
答：README 列出更广的支持范围（Claude Code、Codex、OpenCode、Cursor、Copilot 等）。

**不安装能跑吗？**
答：可以，README 给出 `npx agnix .`。

**怎么接编辑器？**
答：README 提供编辑器扩展与 editor integration 指引。

## 来源与感谢

> Source: https://github.com/agent-sh/agnix
> License: Apache-2.0
> GitHub stars: 239 · forks: 20


---
Source: https://tokrepo.com/en/workflows/agnix-lint-fix-agent-configs
Author: Script Depot