pi-delegate

Delega la implementación y las pruebas en un agente local pi, con hooks que hacen cumplir la disciplina de envío.

Claude actúa como líder técnico: produce la sonda, el cuaderno de tareas, el script de aceptación y el veredicto. pi escribe el código fuente.

Claude nunca habla el protocolo RPC directamente — el servidor MCP es quien mantiene el pipe, y eso es lo que hace posible pi_steer y pi_abort a mitad de ejecución.

Instalación

/plugin marketplace add LarryStanley/pi-delegate
/plugin install pi-delegate@pi-delegate

Ejecuta ambos comandos dentro de Claude Code. El primero registra este repositorio como un marketplace de plugins; el segundo instala el plugin desde él. Si el resumen de instalación dice Run /reload-plugins to activate., ejecuta también ese comando.

Requiere Node ≥ 22 y una instalación de pi que ya esté configurada. Las dependencias se instalan automáticamente desde el lockfile confirmado; no hay nada que tengas que npm install por ti mismo.

Para actualizar más tarde:

/plugin marketplace update pi-delegate

Para ejecutar una copia de trabajo en lugar de la versión publicada:

claude --plugin-dir /path/to/pi-delegate

Una copia con --plugin-dir tiene prioridad sobre la instalada en esa sesión, así que puedes probar cambios sin desinstalarla.

Después ejecuta /pi-delegate:setup para un asistente guiado de primera ejecución: comprueba pi y su proveedor, explica los modos de disciplina y te pregunta cuál quieres, te ofrece arreglar cualquier cosa que se pueda arreglar, y te ofrece un envío de verificación antes de que empieces a usar las herramientas de verdad.

Related MCP server: Claude Code Manager WAN

Configuración: no hace falta nada por defecto

pi_dispatch no especifica ningún proveedor ni modelo, así que pi usa tus propios valores por defecto (defaultProvider / defaultModel en ~/.pi/agent/settings.json). En otras palabras: al modelo que ya apuntes con pi irán también los envíos — anthropic, openai, litellm, ollama, LM Studio o un servidor local compatible con OpenAI (por ejemplo omlx) funcionan igual, sin necesidad de configurar nada específico para este plugin.

Si quieres fijar un modelo distinto a largo plazo (por ejemplo, un modelo local barato dedicado a los envíos mientras el pi interactivo usa otro), escribe ~/.claude/pi-delegate/config.json:

{
  "provider": "ollama",
  "model": "qwen3:8b",
  "timeout_s": 1500,
  "thinking": "off",
  "tools": "read,write,edit",
  "no_context_files": true,
  "drafter_patterns": ["-draft", "_assistant", "-assistant"]
}

Todos los campos son opcionales. El orden de resolución es: argumentos de la llamada a pi_dispatch → este archivo → los valores por defecto de pi.

/pi-delegate:doctor te indica a qué modelo llegará realmente un envío, y solo avisa de un problema cuando una condición se cumple de verdad.

Los valores por defecto de abajo se midieron, no se adivinaron

Para cambiar el comportamiento, especifícalo directamente en la llamada a pi_dispatch (thinking, tools, no_context_files, append_system_prompt, provider, model, timeout_s).

Los flags --mode rpc, --session-id, --no-skills y --no-extensions son estructurales y no se pueden sustituir; --no-session deliberadamente nunca se pasa (omitirlo es lo que hace que la sesión acabe en el disco y que pi_transcript tenga algo que leer).

Modos

A cambiar de modo con /pi-delegate:mode <mode>; el estado se guarda en ~/.claude/pi-delegate/modes.json y se recuerda por proyecto. «Código de producto existente» significa un archivo de código que ya existe dentro de src/ en la raíz del proyecto; tasks/, scripts/, docs/, markdown, archivos de configuración y archivos nuevos pasan sin problema.

strict es un guardarraíl de disciplina, no una imposición: el hook solo está conectado a Write|Edit, así que editar el mismo archivo con Bash (sed -i, un heredoc, python - <<EOF, …) nunca se intercepta. Siempre hay una forma de evitarlo: bloquea que edites el archivo por inercia, no un intento deliberado de saltárselo.

Para hacer una única edición manual (una sonda), ejecuta antes /pi-delegate:probe y tendrás una excepción puntual.

Herramientas MCP

Cómo funciona un envío

La activación del servidor MCP abarca toda la sesión; por eso puede still entregar un steer al stdin del hijo de pi a mitad de ejecución, y por eso es él, no el proceso hijo, quien decide cuándo termina la ejecución.

Carestías conocidas

pi_stats solo devuelve los tokens y duration_s que ya están en el veredicto. No se ha implementado aún el paso directo de get_session_stats (§5 de la spec), que incluya cost / context.

Documentación

Desarrollo

npm test                    # node --test, no external dependencies
claude plugin validate .

fixtures/fake-pi.mjs hace las veces de pi --mode rpc. Está deliberadamente fuera de test/ — node --test trata como archivos de test todo lo que cuelga de **/test/**/*.{cjs,mjs,js}, así que ponerlo allí añadiría un test fantasma que siempre pasa.