agnix

Linter for AI agent configurations. Validates SKILL.md, CLAUDE.md, hooks, MCP, and more.

229 rules | Real-time validation | Auto-fix | Multi-tool support

Installation

npm install -g agnix

Or run directly with npx:

npx agnix .

Usage

Command Line

# Lint current directory
agnix .

# Lint specific file
agnix CLAUDE.md

# Auto-fix issues
agnix --fix .

# JSON output
agnix --format json .

# Target specific tool
agnix --target cursor .

Node.js API

const agnix = require('agnix');

// Async lint
const result = await agnix.lint('./');
console.log(result);

// Sync run
const { stdout, exitCode } = agnix.runSync(['--version']);

// Get version
console.log(agnix.version());

Supported Files

| File | Tool | |------|------| | SKILL.md | Claude Code | | CLAUDE.md, CLAUDE.local.md, AGENTS.md, AGENTS.local.md, AGENTS.override.md | Claude Code, Codex | | .claude/settings.json, .claude/settings.local.json | Claude Code | | plugin.json | Claude Code | | *.mcp.json, mcp.json, mcp-*.json | All | | .github/copilot-instructions.md, .github/instructions/*.instructions.md | GitHub Copilot | | .cursor/rules/*.mdc, .cursorrules | Cursor |

Options

agnix [OPTIONS] [PATH] [COMMAND]

Commands:
  validate   Validate agent configs
  init       Initialize config file
  eval       Evaluate rule efficacy against labeled test cases
  telemetry  Manage telemetry settings (opt-in usage analytics)
  schema     Output JSON Schema for configuration files

Common options:
  -s, --strict
  -t, --target <generic|claude-code|cursor|codex>
  -c, --config <CONFIG>
      --fix
      --dry-run
      --fix-safe
      --format <text|json|sarif>
  -w, --watch
  -v, --verbose
  -V, --version
  -h, --help

Run agnix --help for the full command reference.

Links

• GitHub Repository
• Validation Rules
• VS Code Extension

License

MIT OR Apache-2.0