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 and .claude/rules/*.md (Claude Code), .cursor/rules/*.mdc (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/.

Can agentchecker symlink rule files to AGENTS.md or audit package.json?

Yes! In v0.2.0+, run 'npx agentchecker --symlink' to replace tool-specific rules with relative symlinks to AGENTS.md. Run 'npx agentchecker --audit-deps' to audit rule claims against installed package.json dependencies and lockfiles.

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.

¿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é archivos de agentes IA soporta agentchecker?

agentchecker soporta AGENTS.md (compartido), CLAUDE.md y .claude/rules/*.md (Claude Code), .cursor/rules/*.mdc (Cursor), .github/copilot-instructions.md (GitHub Copilot), .codex/config.toml (Codex), .gemini/gemini.md (Antigravity), .opencode.json (OpenCode), .windsurfrules (Windsurf), .clinerules (Cline/Roo) y .aider.conf.yml (Aider). También lee configuraciones globales en ~/.claude/, ~/.cursor/rules/, ~/.codex/ y ~/.config/opencode/.

¿Puede agentchecker crear symlinks a AGENTS.md o auditar el package.json?

¡Sí! En v0.2.0+, ejecuta 'npx agentchecker --symlink' para reemplazar reglas propietarias con enlaces simbólicos hacia AGENTS.md. Ejecuta 'npx agentchecker --audit-deps' para comprobar si las reglas coinciden con las dependencias instaladas en tu package.json.

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

← Back to agentchecker

Privacy & Cookie Policy

Name: agentchecker
Author: Moisés Valero

Last updated: June 28, 2026

1. Data Controller

Moisés Valero
Contact: info@moisesvalero.es

2. What data we collect

This website is a static landing page. We do not set any first-party cookies or trackers.

Vercel Inc., our hosting provider, may set technical cookies required for CDN functionality and may collect standard server logs (IP address, User-Agent, request timestamp) for security and performance monitoring. Vercel's privacy policy applies to that processing.

3. Third-party services

Vercel — CDN and hosting. Privacy Policy
GitHub — repository hosting (outbound links). Privacy Statement
npm — package registry (outbound links). Privacy Policy
Google Fonts — typography. Font files are loaded from Google servers. See Google Privacy Policy.

4. Your rights (GDPR)

If you are in the EEA, you have the right to access, rectify, erase, restrict processing, and data portability regarding your personal data. To exercise these rights, contact us at info@moisesvalero.es.

5. Changes

We may update this policy. Changes will be posted on this URL with an updated "Last updated" date.