oh-my-pi es un AI Coding Agent para la terminal y el editor. Nace como un fork del proyecto Pi de Mario Zechner y fue ampliado por can1357. Su objetivo no es ofrecer solo una interfaz de chat en línea de comandos, sino conectar lectura de archivos, búsqueda de código, ediciones estructuradas, LSP, depuradores, navegador, subagentes y múltiples proveedores de modelos dentro de un mismo flujo de trabajo.
Según el README del proyecto, se parece más a una capa de herramientas para programación con IA que a un asistente sencillo: se puede usar de forma interactiva en la terminal, conectar con editores mediante ACP o integrar en proyectos Node mediante el SDK. Para quienes ya usan Claude Code, Codex CLI, Cline, Cursor u otras herramientas tipo Agent, lo interesante de oh-my-pi es que convierte muchas capacidades normalmente dispersas en herramientas externas en una superficie integrada.
Qué problema intenta resolver
En muchas herramientas de programación con IA, el punto débil no es el modelo, sino la interfaz de herramientas que lo rodea. Si el modelo quiere modificar código pero solo puede leer archivos completos de forma poco precisa, hacer reemplazos frágiles de cadenas y ejecutar shell de una sola vez, la propia herramienta amplifica los fallos.
oh-my-pi intenta reducir esos puntos de fricción:
- Al leer archivos, prioriza resúmenes estructurados en vez de meter archivos completos en el contexto.
- Search, glob, find, resaltado de sintaxis y conteo de tokens se implementan de forma nativa cuando es posible, reduciendo la dependencia de comandos externos.
- Al escribir código, puede usar LSP para que renombrados, referencias y movimientos de archivos se comporten más como operaciones de IDE.
- Para depurar, puede usar herramientas DAP como
lldb,dlvydebugpy, en vez de depender solo de logs y suposiciones. - Las tareas complejas se pueden dividir entre subagentes y devolver como resultados estructurados.
- Las ediciones usan anclas de contenido y vista previa para reducir la posibilidad de que un patch incorrecto se escriba directamente en disco.
Estas decisiones muestran que el foco no es “si el modelo puede responder”, sino “si el modelo puede completar de forma fiable un cambio real en el código”.
Instalación
El proyecto ofrece varias vías de instalación. En macOS y Linux se puede usar el script de instalación:
|
|
Si usas Bun, el README recomienda instalar globalmente el paquete npm:
|
|
En Windows PowerShell:
|
|
El README también menciona fijar versiones con mise:
|
|
Antes de instalar, conviene revisar el requisito de versión de Bun. El README indica soporte para macOS, Linux y Windows, y requiere bun >= 1.3.14.
Capacidades que conviene observar
1. Las llamadas a herramientas van más allá del shell
oh-my-pi incluye herramientas para leer archivos, buscar, escribir, editar, hacer ediciones AST, usar navegador, dividir tareas, depurar y trabajar con LSP. El README menciona 32 herramientas integradas, 13 operaciones LSP y 27 operaciones DAP.
Eso significa que el Agent no tiene que envolver todo como salida de línea de comandos. La búsqueda de referencias puede ir por LSP, los PR e issues pueden leerse mediante una interfaz unificada parecida a un sistema de archivos, y las páginas web o PDF pueden convertirse a Markdown conservando la estructura de enlaces antes de entregarse al modelo.
2. La integración LSP sirve en bases de código reales
En proyectos grandes, renombrar o mover archivos suele romper re-exports, imports con alias, barrel files o referencias entre directorios. El README de oh-my-pi destaca que las rutas de escritura pueden pasar por LSP. Por ejemplo, los renombrados de archivos usan workspace/willRenameFiles, acercando la edición a una operación semántica de IDE.
Esto es útil para refactorizaciones diarias en TypeScript, Rust, Go, Python y proyectos similares, sobre todo cuando el cambio manual es posible pero fácil de dejar incompleto.
3. El depurador es una herramienta de primera clase
Muchos flujos de programación con IA siguen depurando mediante logs, nuevas ejecuciones y lectura de salida. oh-my-pi conecta depuradores DAP a la superficie de herramientas. El README da ejemplos con programas en C usando lldb, servicios Go usando dlv y procesos Python usando debugpy.
Esto cambia cómo un Agent aborda un bug: puede pausar un proceso, inspeccionar frames de la pila, leer variables locales y decidir el siguiente paso, en vez de adivinar solo desde el texto del error.
4. Hashline reduce fallos de patch
El proyecto enfatiza Hashline, un método de edición basado en anclas de contenido. La idea es que el modelo apunte al contenido que quiere cambiar, en lugar de emitir diffs grandes una y otra vez. Esto reduce errores causados por espacios, contexto obsoleto o fallos al encontrar cadenas.
Para una herramienta tipo Agent, este mecanismo importa mucho. Aunque el modelo sea capaz, si la interfaz de escritura falla constantemente, la experiencia termina siendo una cadena de reintentos.
5. Subagentes y aislamiento de workspace
El README presenta la capacidad de subagentes con task: una tarea puede dividirse entre workers aislados, y los resultados vuelven como objetos estructurados. El proyecto también incluye lógica de aislamiento de workspace para tareas paralelas, exploración por ramas y prevención de ediciones solapadas.
Esto encaja con revisión de código, migraciones, arreglos masivos e investigación de tests. El valor no es solo que sea más rápido en paralelo, sino que separa mejor los caminos de exploración y sus cambios.
6. Puede heredar reglas y configuraciones existentes
En el primer arranque, oh-my-pi puede leer reglas y configuraciones dejadas por otras herramientas, incluyendo .claude, .cursor, .windsurf, .gemini, .codex, .cline, .github/copilot y .vscode.
Esto es práctico. Muchos equipos ya han escrito reglas para varias herramientas de IA. Migrarlas de nuevo para cada herramienta es costoso, así que oh-my-pi intenta reutilizar lo que ya existe en disco.
Cuatro formas de entrada
El proyecto ofrece cuatro formas principales de uso:
- TUI interactiva: ejecutar
ompdirectamente en la terminal. - Comando de una sola vez: usar
omp -ppara enviar un único prompt. - Node SDK: integrarlo en un proyecto Node o TypeScript mediante
@oh-my-pi/pi-coding-agent. - RPC / ACP: conectar otros programas y editores mediante stdio o Agent Client Protocol.
Esto significa que no está pensado solo para usuarios individuales de terminal. También deja espacio para IDE, plugins, plataformas de automatización y herramientas internas.
Para quién tiene sentido
oh-my-pi encaja especialmente con:
- Desarrolladores que editan, depuran y revisan código a menudo desde la terminal.
- Personas que ya usan AI Coding Agents, pero no están satisfechas con la lectura de archivos, patch, búsqueda o depuración.
- Desarrolladores que quieren conectar un Agent a un editor, una capa RPC o un servicio Node.
- Usuarios que necesitan alternar entre varios modelos y proveedores en una misma herramienta.
- Creadores de herramientas interesados en LSP, DAP, edición AST y flujos con subagentes.
Si solo quieres un asistente de código tipo chat que funcione de inmediato, la curva de aprendizaje puede parecer alta. Está más orientado a quienes aceptan entender la cadena de herramientas y tratar el Agent como un entorno de desarrollo configurable.
Qué tener en cuenta
Primero, oh-my-pi sigue siendo un proyecto open source de evolución rápida. Hay commits frecuentes y muchos issues y pull requests, así que la instalación y el uso pueden cambiar.
Segundo, sus capacidades dependen mucho del entorno local. LSP, depuradores, Bun, autenticación de proveedores de modelos, configuración de terminal y diferencias entre Windows y Unix pueden afectar la experiencia.
Tercero, tener muchas herramientas integradas no significa que haya que activarlas todas en cada caso. En la práctica conviene habilitar las necesarias para la tarea y configurar bien reglas, permisos y límites de workspace.
Cuarto, un AI Agent puede escribir código, pero también puede cambiar el código equivocado. Incluso con vistas previas y ediciones ancladas por contenido, los proyectos importantes siguen necesitando control de versiones, tests y revisión humana.
Resumen
Lo interesante de oh-my-pi no es que sea otra shell de IA para la terminal. Lo interesante es que reorganiza la capa de herramientas que suele frenar la programación con IA: lectura de archivos, búsqueda, edición, LSP, depuración, navegador, subagentes e integración SDK dentro de un único flujo de Agent.
Vale la pena seguirlo si te interesa la infraestructura de programación con IA o si quieres comparar distintas rutas de Coding Agent. La competencia entre herramientas de programación con IA ya no va solo de la calidad de las respuestas del modelo. También consiste en quién logra conectar los modelos de forma fiable con bases de código reales, flujos reales de depuración y reglas reales de equipo. oh-my-pi es un intento open source ambicioso en esa dirección.
Referencias:
- Proyecto en GitHub: https://github.com/can1357/oh-my-pi
- Sitio oficial: https://omp.sh/
- Documentación del SDK: https://omp.sh/docs/sdk