¿Qué es agentchecker?

agentchecker es una herramienta de línea de comandos sin instalación que detecta y corrige contradicciones entre archivos de instrucciones de agentes IA en un proyecto. Escanea AGENTS.md, CLAUDE.md, reglas de Cursor (.cursor/rules/), instrucciones de Copilot (.github/copilot-instructions.md), Codex, OpenCode, Windsurf y Aider, y luego te pregunta qué valor es el correcto para unificar todos los archivos.

¿Cómo ejecuto agentchecker?

Ejecuta agentchecker sin instalar nada con npx: abre una terminal en la raíz de tu proyecto y ejecuta 'npx agentchecker'. No requiere configuración ni instalación global.

¿Qué contradicciones detecta agentchecker?

agentchecker detecta contradicciones en seis categorías: gestor de paquetes (pnpm vs npm vs yarn vs bun), linter (oxlint vs eslint vs biome), formateador (prettier vs biome vs dprint), test runner (vitest vs jest), entorno shell (WSL2 vs Windows vs macOS) y ejecutor de paquetes (npx vs pnpm dlx vs bunx).

¿agentchecker modifica archivos globales de herramientas IA?

No. agentchecker lee archivos globales (como ~/.claude/CLAUDE.md o ~/.cursor/rules/) para detectar contradicciones, pero nunca los modifica. Solo actualiza archivos locales del proyecto. Si no hay configuración local, puede crear un AGENTS.md con los valores elegidos.

¿agentchecker es gratuito?

Sí, agentchecker es completamente gratuito y de código abierto. Ejecútalo al instante con npx agentchecker: sin instalación, sin cuenta y sin configuración.

v0.1.8 on npm

AGENTCHECKER.

Scans AGENTS.md, CLAUDE.md, Cursor rules, and Copilot instructions in one command. Surfaces package manager, linter, and formatter conflicts in under 2 seconds.

agentchecker — ~/my-app

$ npx agentchecker

agentchecker

Found: ✓ .cursor/rules/global.mdc · AGENTS.md · CLAUDE.md

⚠ 2 contradictions found:

Package manager

.cursor/... → npm

CLAUDE.md → npm

AGENTS.md → pnpm

→ pnpm

Linter

.cursor/... → eslint

CLAUDE.md → eslint

AGENTS.md → oxlint

→ oxlint

◇ Fix? Yes · pnpm · oxlint

CLAUDE.md

- Run `npm install` before starting.

+ Run `pnpm install` before starting.

✓ Fixed 2 files. All your agents agree.

VIEW ON GITHUB DOCUMENTATION

QUICK INSTALL $ npx agentchecker

Scanned agent paths

✓ AGENTS.md
✓ CLAUDE.md · .claude/CLAUDE.md
✓ .cursor/rules/*.mdc · .cursorrules
✓ .github/copilot-instructions.md
✓ .windsurfrules · .clinerules · .roo/rules
✓ Codex · OpenCode · Aider · Antigravity

CI check

Fails the workflow when project rules disagree:

$ npx agentchecker --check-only --local-only

CI setup in README

Frequently asked questions

What is agentchecker?

agentchecker is a zero-install command-line tool that detects and fixes contradictions between AI agent instruction files in a project. It scans files like AGENTS.md, CLAUDE.md, Cursor rules (.cursor/rules/), GitHub Copilot instructions (.github/copilot-instructions.md), Codex, OpenCode, Windsurf, and Aider configurations, then asks you which setting is correct and updates all files to agree.

How do I run agentchecker?

Run agentchecker without installation using npx: open a terminal in your project root and run 'npx agentchecker'. No configuration files or global installation required.

What AI agent files does agentchecker support?

agentchecker supports AGENTS.md (shared), CLAUDE.md (Claude Code), .cursor/rules/ (Cursor), .github/copilot-instructions.md (GitHub Copilot), .codex/config.toml (Codex App), .gemini/gemini.md (Antigravity), .opencode.json (OpenCode), .windsurfrules (Windsurf), .clinerules (Cline/Roo), and .aider.conf.yml (Aider). It also scans global config files in ~/.claude/, ~/.cursor/rules/, ~/.codex/, and ~/.config/opencode/.

What contradictions does agentchecker detect?

agentchecker detects contradictions in six categories: package manager (pnpm vs npm vs yarn vs bun), linter (oxlint vs eslint vs biome), formatter (prettier vs biome vs dprint), test runner (vitest vs jest), shell environment (WSL2 vs Windows vs macOS), and package runner (npx vs pnpm dlx vs bunx).

Does agentchecker modify global AI tool configuration files?

No. agentchecker reads global configuration files (like ~/.claude/CLAUDE.md or ~/.cursor/rules/) to detect contradictions, but it never modifies them. Only local project files are updated. If no local config exists, agentchecker offers to create an AGENTS.md file with your chosen settings.

Is agentchecker free?

Yes, agentchecker is completely free and open source. Run it instantly with npx agentchecker — no installation, no account, no configuration required.