El agente de programación Pi explicado: qué es, cómo funciona y qué cambió con Pi 1.0

¿Qué es el agente de programación Pi?

Pi se describe en una línea en su README: "a minimal, extensible agent harness that you can make your own." Un arnés (harness) es el programa que envuelve un modelo de lenguaje con un bucle, herramientas y una interfaz de usuario, para que el modelo pueda leer archivos, ejecutar comandos y editar código de verdad. Claude Code, OpenAI Codex y OpenCode también son arneses, y juntos forman la categoría de CLI de programación agéntica. Lo que distingue a Pi es lo poco que incluye y lo mucho que te deja cambiar.

Las cifras dicen que hace tiempo que dejó de ser una herramienta de nicho:

Una advertencia sobre esa cifra de descargas: los números de npm incluyen ejecuciones de CI y aplicaciones que incrustan el SDK de Pi, así que no son un recuento de personas. Aun así, 5,2 millones a la semana colocan a Pi en otra liga respecto a la mayoría de los agentes de código abierto, incluido el mucho más joven DeepSeek Harness.

Pi también es más grande que su propia CLI. El agente personal OpenClaw, que tiene 391,521 estrellas propias, está construido sobre componentes de Pi. Armin Ronacher lo dijo claramente en su artículo sobre Pi: "what's under the hood of OpenClaw is a little coding agent called Pi."

¿Quién construye Pi y por qué pasó a Earendil?

Pi empezó como un proyecto personal de Mario Zechner, un desarrollador austríaco conocido sobre todo por el framework de juegos libGDX. Su detonante fue la frustración con Claude Code, que según su artículo de diseño se había convertido en una "spaceship with 80% of functionality I have no use for", con prompts y herramientas que cambiaban en cada versión. Construyó un arnés donde nada se inyecta a tus espaldas y le puso, en sus palabras, "a name that's entirely un-Google-able, so there will never be any users."

Ese plan no sobrevivió a OpenClaw. Cuando el agente de Peter Steinberger se hizo viral y la gente supo que funcionaba con Pi, Mario escribió que "any VC or big corp you can think of in this space has knocked on my door." No quería montar una startup alrededor de esto, así que eligió un hogar.

Earendil es una corporación de beneficio público con sede en Viena, fundada en 2025 por Armin Ronacher (creador de Flask, unos diez años en Sentry) y Colin Daymond Hanna. Entre sus inversores figuran Accel, Balderton y los fundadores de n8n, OpenClaw, Revolut, Sentry y Slack. La promesa de licencia está en el RFC de Armin: "Pi remains MIT licensed and that will not change." Algunas funciones de valor añadido futuras serán de código disponible y pasarán a código abierto tras un retraso, y algunas funciones empresariales serán propietarias.

No a todos les gustó el cambio. Una respuesta en r/LocalLLaMA lamentaba perder "the only decent harness that isn't sketchy af." Seis meses después, el historial de commits responde mejor: Mario aún tiene 3,849 commits en el repositorio y Armin 849, y el núcleo sigue siendo MIT.

Cómo funciona el agente de programación Pi

Todo el diseño cabe en una servilleta. Un modelo, un bucle que "just loops until the agent says it's done" y cuatro herramientas.

El razonamiento de Mario para un núcleo tan pequeño es que los modelos de frontera ya saben lo que es un agente de programación. "There does not appear to be a need for 10,000 tokens of system prompt," escribió, y "these four tools are all you need for an effective coding agent." Existen ayudantes de solo lectura (grep, find, ls), pero están desactivados por defecto. Las reglas de tu proyecto salen de un archivo AGENTS.md (Pi también lee CLAUDE.md), muy parecido a la configuración de AGENTS.md en Claude Code, y un SYSTEM.md puede reemplazar por completo el prompt por defecto.

Esa captura muestra el hábito que los usuarios de Pi adoran. Pídele a Pi que se añada una función a sí mismo y lee su propia documentación, escribe una extensión en su carpeta de configuración y tú ejecutas /reload. El pie también muestra el contexto usado y el coste en dólares en cada turno, un detalle pequeño que cambia la forma de trabajar.

Algunas otras mecánicas que conviene conocer antes de instalarlo:

• Las sesiones son árboles. Cada mensaje se guarda con un ID de padre en un archivo JSONL, así que /tree te permite volver a cualquier punto y ramificar, y /fork o /clone inician una sesión nueva desde ahí. /share convierte una sesión en un enlace compartible.
• Dirigir sobre la marcha. Pulsa Enter mientras Pi trabaja para enviar un mensaje de guía, o Alt+Enter para encolar un seguimiento para cuando termine.
• Compactación. Cuando el contexto se llena (por defecto, a menos de 16,384 tokens del límite), Pi resume los mensajes antiguos y mantiene intactos los últimos 20,000 tokens. Earendil escribió sobre cómo funciona la compactación si quieres los detalles internos.
• 30+ proveedores. Anthropic, OpenAI, Google, Bedrock, Mistral, Groq, xAI, OpenRouter, Ollama y más, con /model para cambiar a mitad de sesión. El catálogo de modelos de Pi lista 1,541 modelos de 41 proveedores.

Qué deja fuera Pi a propósito

Esta es la parte que desconcierta a la mayoría de los usuarios nuevos, así que aquí va en una sola tabla. Cada una es una decisión deliberada y cada una tiene una alternativa documentada.

El argumento de Mario para dejarlas fuera trata de visibilidad. Sobre los subagentes, de su artículo de diseño: "You have zero visibility into what that sub-agent does. It's a black box within a black box." Sobre el modo de planificación, prefiere un archivo PLAN.md que puedas leer, editar y confirmar en el repositorio. Si has usado subagentes de Claude Code y te gustaron, querrás el paquete, y está bien. La propuesta de Pi es que tú eliges.

La comunidad ha rellenado todos los huecos. El catálogo de paquetes muestra 5,553 paquetes listados, y varios de los más descargados corresponden directamente a la tabla anterior:

Las propias extensiones son archivos TypeScript sencillos que pueden registrar herramientas, comandos con barra, atajos de teclado, proveedores de modelos y una interfaz de terminal completa. La extensión de revisión de Armin es un buen ejemplo de hasta dónde llega esto:

La contrapartida es que te conviertes en el mantenedor de tu propia configuración. Un usuario veterano de Pi en Hacker News lo expresó con justicia: "Pi's plugins are its strength, but also its weakness, because most feel more like personal vibe-coding projects than seriously maintained tools." La documentación dice lo mismo con más sobriedad: los paquetes pueden ejecutar código, así que "review third-party package source before installing it."

Pi 1.0: el agente "sin MCP" ahora tiene MCP

Durante casi toda su vida, pi.dev lució una frase orgullosa que decía que Pi nunca admitiría MCP, el protocolo que permite a un agente conectarse a un servidor MCP externo. El argumento de Mario era el coste de contexto. Midió el servidor MCP de Playwright en 21 herramientas y 13.7k tokens, y Chrome DevTools MCP en 26 herramientas y 18k tokens, lo que llamó "7-9% of your context window gone before you even start working."

El 29 de septiembre de 2026, Earendil lo revirtió en un artículo titulado "You Said No MCP!" Su razonamiento: "the MCP of today is not the MCP of yesteryear," y los cambios que MCP necesitaba eran "generally useful." Dos días después salió Pi 1.0 con MCP como función estrella. La página de inicio ahora dice "No MCP Now with MCP+Codemode."

El truco que mantiene la promesa de tokens es Codemode. En lugar de entregar al modelo el esquema de cada herramienta MCP, Pi le da una sola herramienta que ejecuta scripts cortos de JavaScript en un entorno aislado QuickJS sin sistema de archivos, red ni temporizadores propios.

La documentación de Codemode lo dice sencillamente: "Only the script's output reaches the model, so a script can run calls in parallel and filter large results before the model sees them." El changelog de Pi 1.0 afirma que Codemode ahora usa cerca de un 40 % menos de tokens de prompt, y que una solicitud de GPT-5.6 pasó de unos 5,300 a 3,300 tokens. Cada servidor MCP tiene un ajuste de exposición:

• codemode (por defecto): las herramientas solo se pueden llamar desde scripts de Codemode.
• deferred: las herramientas se declaran solo después de que tool_search las encuentre.
• direct: las herramientas se cargan como las integradas, como hacen la mayoría de los arneses.
• hidden: registradas pero inaccesibles, útil para herramientas tipo delete_*.

La configuración vive en ~/.pi/agent/mcp.json o en el .pi/mcp.json de un proyecto, con el mismo formato mcpServers que Claude Desktop y Cursor, así que puedes pegar entradas existentes. Si vienes de las herramientas MCP de Claude Code, el principal cambio mental es que el modelo escribe código para llamar a las herramientas en lugar de llamarlas una por una.

¿Fue una traición a los minimalistas? La respuesta de Mario en Hacker News: "All of these features are still entirely optional and the only thing I could think of that could be considered "bloat" is the additional few megabytes for the QuickJS WASM blob." La explicación de Armin fue más pragmática:

"we look at what the models are doing. They are trained on their respective harnesses and we're not here to fight their behavior."

the_mitsuhiko, Hacker News

Pi 1.0 también añadió carga diferida de herramientas, precalentamiento de caché para modelos de Anthropic, compatibilidad de extensiones con "modelos virtuales" (una demo planifica con Claude Opus e implementa con GPT) y convirtió el modo de pantalla completa en el predeterminado. El hilo de Pi 1.0 alcanzó 1,686 puntos en Hacker News, unas tres veces más que cualquier discusión anterior sobre Pi.

Cuatro formas de ejecutarlo

Pi no es solo una ventana de chat en tu terminal. El mismo agente y motor de sesiones funcionan en cuatro modos:

El SDK es como OpenClaw y otros productos se construyen sobre Pi, y es la misma idea que el SDK de Claude Code para agentes de programación personalizados. El modo print es la estrella discreta: así fingen subagentes los usuarios de Pi (Pi llama a pi --print mediante bash) y así integran Pi en automatización al estilo Claude Code.

El 1 de octubre, Earendil también lanzó Pi Durable, una biblioteca experimental con licencia MIT para "long-running, durable, and malleable agents that can run anywhere." Guarda un punto de control en cada paso para que una ejecución sobreviva a un fallo, permite que muchas personas se conecten a una misma conversación y almacena el estado de la aplicación, como tickets o planes, junto a la transcripción. "does not replace the Pi coding agent", y no es un producto alojado. Su gancho de aprobación de ejemplo pregunta en Slack antes de ejecutar una herramienta deploy, y Earendil dice que vienen un bot de Slack y un bot de triaje de GitHub construidos sobre ella. Ten esto presente para la sección de soporte más abajo.

¿Es seguro usar el agente de programación Pi?

Esta es la línea de la propia documentación de seguridad de Pi, que leería dos veces: Pi "can read, change, and execute files with the permissions of the account that started it, and it does not ask for approval before every tool call."

Ese es el famoso modo YOLO por defecto, y es una postura, no un descuido. Mario llamó a las barreras de otros agentes "mostly security theater" en su artículo de diseño, argumentando que, una vez que un agente puede escribir y ejecutar código, un cuadro de confirmación no aporta mucho. La documentación coincide y añade que "watching the transcript, using project trust, and reviewing changes do not create a security boundary." Su recomendación es ejecutar Pi dentro de un contenedor, una VM o un entorno aislado, y documentan recetas para Docker, Docker Sandboxes, NVIDIA OpenShell y la microVM Gondolin.

Los usuarios nuevos aún se llevan sorpresas:

"I love Pi, but minimal mean minimal. I realized it when it rm -f /tmp/somefile.log without asking for permission."

u/mantafloppy, Reddit r/LocalLLaMA

Y la solución casera tiene lagunas. Otro comentarista del mismo hilo señaló que la extensión de permisos de ejemplo "blocks rm -rf, but not rm -fr which does the exact same thing" (u/GalladeGuyGBA). Esa es la verdad honesta sobre las barreras basadas en patrones, y es exactamente por lo que la documentación de Pi te empuja hacia un entorno aislado de verdad.

Tres valores por defecto más que conviene conocer:

1. Confianza en el proyecto. La configuración a nivel de proyecto (.pi/settings.json, .pi/mcp.json, extensiones y skills del proyecto) solo se carga después de que apruebes la carpeta. AGENTS.md y CLAUDE.md se cargan siempre.
2. Telemetría. El informe anónimo de instalación y actualización está activado por defecto (enableInstallTelemetry: true); desactívalo con PI_TELEMETRY=0. Las analíticas son opcionales. --offline detiene las llamadas de red automáticas.
3. Cadena de suministro. Pi se instala mediante npm, y sus paquetes también. Un usuario de Reddit dijo que su VM de trabajo se vio comprometida cuando una dependencia transitiva fue secuestrada durante una ventana de actualización de npm i -g de unos 30 minutos. El README ahora recomienda el instalador fijado pi.dev/install.sh, que fija todas las dependencias.

Mi opinión: ejecuta Pi en un contenedor para cualquier cosa desatendida, instala paquetes como instalarías cualquier código de npm y deja tus expectativas de avisos de permisos en cero. Si tu equipo necesita avisos de aprobación por defecto, el modelo de permisos de Claude Code resultará más seguro desde el primer momento.

¿Cuánto cuesta el agente de programación Pi?

Pi en sí es gratis. No hay precio por usuario, ni plan de pago, ni página de precios, porque el arnés con licencia MIT es todo el producto. Lo que pagas es el modelo que hay detrás, y Pi te ofrece tres formas de traer uno.

Dos salvedades. Primero, el changelog de Pi dice que Pi avisa de que "Anthropic third-party usage draws from extra usage and is billed per token" cuando inicias sesión con una suscripción de Claude, así que no des por hecho que tu plan Max cubre Pi como cubre Claude Code. Mi guía de precios de Claude Code explica cómo miden esos planes. Segundo, los inicios de sesión de Gemini CLI y Antigravity de Google se eliminaron en la versión 0.71.0 (30 de abril de 2026), así que Gemini ahora necesita una clave de API o Vertex AI.

Donde Pi se gana su sitio es en la eficiencia de tokens. Como el prompt de sistema es tan pequeño, el almacenamiento en caché de prompts funciona bien y cada turno envía menos. Una prueba comparativa de Databricks en una base de código de varios millones de líneas, recogida por Earendil, concluyó que "simple harnesses like Pi performed best" en sus cargas de trabajo, con Pi enviando unas tres veces menos contexto por turno.

Tómalo como un dato cercano al proveedor, no como dogma; Earendil cita un estudio que favorece a su producto. Pero usuarios individuales informan de lo mismo. Un comentarista de Hacker News hizo pruebas de tokens y encontró que "both pi and my own 3code used 4x fewer tokens than Claude Code, while opencode used 2x fewer tokens than Claude Code." Otro dijo que sesiones enteras de perfilado y refactorización terminan "in <20k tokens." En la clasificación anterior de Terminal-Bench 2.0 (diciembre de 2025), Pi con Claude Opus 4.5 quedó en el puesto #7 con 49.8%, por delante de Claude Code con Sonnet 4.5 en el #18 con 40.1%.

Qué dicen los desarrolladores de Pi

Los elogios son coherentes en todas las plataformas: un prompt pequeño, bajo uso de tokens, transparencia y un agente que puedes moldear. El respaldo individual más fuerte viene de X:

"Pi is the best agent harness and more importantly framework we have right now. The stats are stunning: - highest cache hit rate - lowest latency - highest performance - smallest bundle - cleanest code - cheapest cache + tiny system prompt over months adds up. Try it"

0xSero, X

A los usuarios de modelos locales les gusta por una razón fácil de pasar por alto. Un prompt de sistema enorme tarda minutos en precargarse en un portátil, y el de Pi no:

"Love pi. I tried to run some local models and pi was the only one that actually worked decently because it didn't have a gargantuan system prompt that would take minutes to prefill on my scrawny ass laptop."

FacelessJim, Hacker News

A otros les encanta que se aparte del camino mientras los proveedores siguen cambiando sus herramientas:

"The result is that the tool gradually morphs into the thing I need rather than me having to adapt myself to whatever new thing Anthropic or OpenAI comes up with."

unknownfuture, Hacker News

Las críticas son igual de coherentes, y justas. La queja más común es que "todo es un plugin" significa hacer trabajo de configuración que otros agentes hacen por ti:

"Need to set the reasoning effort? Install pi-reasoning. Need subagents? Install pi-subagents. Need permission gating? Install one of the permission extensions (otherwise the agent can do everything)."

mixermachine, Hacker News

El mejor resumen en una línea que encontré salió de un hilo que compara Pi con OpenCode: "Pi vs opencode for example is like gentoo vs macos." En Reddit, el consejo a los recién llegados es resistirse a instalarlo todo el primer día. Como lo dijo un usuario de r/PiCodingAgent: "Pi actually works pretty well out of the box." A quienes quieren todo incluido suelen remitirlos al fork oh-my-pi o a OpenCode.

Agente de programación Pi vs Claude Code

Como la mayoría llega a Pi desde Claude Code, aquí tienes la comparación directa de lo que realmente cambia tu día.

Mi lectura: si usas sobre todo modelos Claude y quieres barreras de seguridad, un conjunto de funciones estable y un único proveedor al que culpar, quédate con Claude Code. Si cambias de modelo a menudo, te importan los tokens, ejecutas modelos locales o quieres ser dueño de cada línea que ve el agente, Pi es la herramienta más interesante, y su lanzamiento 1.0 la hizo mucho más fácil de adoptar. Para un panorama más amplio que incluya Cursor y GitHub Copilot, mi resumen de asistentes de programación con IA es el mejor punto de partida.

¿Deberías construir un agente de soporte sobre Pi?

Es un pensamiento razonable. Pi tiene un SDK, un modo RPC y ahora Pi Durable, cuyos propios ejemplos hablan de bots de Slack, ganchos de aprobación y bots de triaje. Los modelos son más baratos que nunca. ¿Por qué no conectar Pi a tu helpdesk y llamarlo agente de soporte?

Porque el arnés es la parte más pequeña del trabajo. Así veo yo el reparto:

Un agente de soporte necesita una conexión bidireccional con tu helpdesk (leer el ticket, etiquetarlo, responder, escalar), una forma de mantener sincronizados tu centro de ayuda, tus macros y tus tickets anteriores a medida que cambian, reglas sobre lo que puede hacer sin una persona y una forma de probarlo con tickets pasados reales antes de que hable con un cliente. Ese último paso es el que nunca me saltaría. eesel lo aprendió por las malas, viendo a un bot de sonido seguro dar respuestas erróneas durante días antes de que alguien lo notara, y por eso cada despliegue de eesel ahora se simula primero con tickets históricos.

También veo la tentación de construirlo uno mismo desde el otro lado. Varios clientes de eesel, entre ellos una empresa de realidad aumentada y tecnología de la construcción y una marca de belleza DTC, se han ido para construir directamente sobre la API de Claude. Y los equipos que se quedan suelen decir lo mismo. Un líder de ingeniería de GENERAL BYTES, el fabricante de cajeros de Bitcoin, explicó por qué eligieron comprar en lugar de construir:

"We could try to write our own LLM application but we didn't want to invest our time into that. We wanted something that we would not have to maintain."

Así que mi respuesta: construye sobre Pi si a tu equipo le gusta ser dueño de todo el stack y tiene tiempo para seguir el ritmo de un proyecto que publica versiones de parche casi a diario. Si el objetivo son tickets respondidos y no un framework que mantener, contrata al compañero y deja que Pi haga lo que se le da genial, que es escribir código.

Prueba eesel

Pi es el arnés; eesel es el empleado. eesel es una plataforma de compañeros de IA donde contratas compañeros listos para trabajar en tareas concretas. Para soporte, ese es el compañero de IA para helpdesk: se conecta en minutos a Zendesk, Freshdesk, Gorgias y Slack, aprende de tus tickets anteriores y de tu centro de ayuda, y puedes simularlo con tu propio historial de tickets antes de que responda a un solo cliente. Si lo que necesitas es contenido en lugar de tickets, la misma plataforma tiene un compañero redactor de blog con IA.

Lo que les gustará a los usuarios de Pi: no tienes que salir de la terminal. La CLI de eesel maneja el mismo compañero y espacio de trabajo que el panel, "another way in, not a separate copy." npx @eesel/cli init configura un agente sin necesidad de cuenta, eesel integrations connect zendesk conecta tu helpdesk (una persona lo aprueba dentro de Zendesk), eesel instructions edita las reglas permanentes del agente en texto sencillo, eesel approvals list muestra las acciones que esperan a una persona y eesel activity te deja leer cada ejecución. Cada comando imprime JSON y admite --dry-run, y los errores llegan con un campo hint, que es justo lo que necesita un agente de programación para manejar una herramienta por sí solo.

La documentación de eesel nombra a Claude Code, Cursor y Codex, pero nada impide que Pi haga el mismo trabajo: puede ejecutar la CLI mediante su herramienta bash, o conectarse al servidor MCP que expone cada espacio de trabajo de eesel (eesel mcp token imprime la URL y un token de 30 días), ahora que Pi 1.0 habla MCP. Las configuraciones sin interfaz usan EESEL_API_URL, EESEL_API_TOKEN y EESEL_AGENT_ID. Mis guías sobre una CLI de agentes de IA y una CLI para atención al cliente profundizan más.

Puedes empezar con el plan gratuito con 100 créditos y sin tarjeta. Los planes de pago de compañeros empiezan en $299 al mes por 500 créditos, y un ticket o chat es un crédito sin importar cuánto dure. Los comandos de configuración y observación de la CLI son gratuitos; solo se factura el chat. Es el camino más corto si quieres tickets resueltos, y aun así puedes dejar que Pi haga el tecleo.