becwright

Guías

Agentes de IA

Instalá y manejá becwright desde Claude Code o cualquier agente compatible con MCP como Cursor, Windsurf u opencode.

becwright está pensado para que un agente de IA lo configure y lo corra por vos. CLAUDE.md y .cursorrules le piden al agente que se porte bien; becwright es la red determinista que verifica el resultado en cada commit. Hay dos formas de conectarlo a un agente — un plugin dedicado de Claude Code y un camino genérico que sirve para cualquier agente que hable MCP o que pueda correr un comando.

Claude Code (plugin)

Claude Code tiene un plugin de primera clase. Instalalo desde el marketplace de becwright:

/plugin marketplace add DataDave-Dev/becwright
/plugin install becwright@becwright

El primer comando registra el repo como marketplace de plugins; el segundo instala el plugin desde ahí. No empaqueta becwright — instala el paquete publicado becwright (npm / PyPI) en tu proyecto.

Lo que obtenés:

  • Skill becwright — le enseña al agente qué es becwright, cómo instalarlo (npm/pnpm, sin Python, o pipx), cómo generar reglas y cómo leer y arreglar la salida de check. El agente lo invoca solo cuando pedís una barrera, un chequeo pre-commit o una regla que “no se pueda ignorar”.
  • Comando /becwright — un punto de entrada directo:
ComandoQué hace
/becwright initInstala becwright y genera .bec/rules.yaml + hook
/becwright checkCorre las reglas y resume PASS / WARN / BLOCK
/becwright add <regex-o-url>Agrega una regla forbid o importa una BEC
/becwright statusInforma instalación + hook + cantidad de reglas

Cualquier agente compatible con MCP

Cursor, Windsurf, opencode y cualquier otro cliente MCP pueden usar becwright a través de su servidor MCP — sin plugin dedicado. Apuntá la configuración MCP del agente al comando:

{
  "mcpServers": {
    "becwright": {
      "command": "becwright",
      "args": ["mcp"]
    }
  }
}

Esto expone check y list_checks como herramientas estructuradas. El servidor MCP viene con el paquete de Python (pipx install "becwright[mcp]"). Mirá MCP y salida JSON para los esquemas de las herramientas y el formato JSON.

Cualquier agente con shell

No necesitás ninguna integración. becwright es una CLI común, así que cualquier agente que pueda correr comandos — incluido opencode — lo maneja directo:

npm install --save-dev becwright   # sin Python
npx becwright init                 # genera reglas + hook pre-commit
npx becwright check --all          # corre todas las reglas sobre el repo
npx becwright check --json         # resultados legibles por máquina para parsear

Como el hook pre-commit es nativo, los checks corren en cada commit sin importar qué agente hizo el cambio — ese es el punto: la garantía no depende de que el agente coopere.