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 decheck. 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:
| Comando | Qué hace |
|---|---|
/becwright init | Instala becwright y genera .bec/rules.yaml + hook |
/becwright check | Corre las reglas y resume PASS / WARN / BLOCK |
/becwright add <regex-o-url> | Agrega una regla forbid o importa una BEC |
/becwright status | Informa 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.