Desarrollo

Consulta AGENTS.md para directrices adicionales.

Configuración

git clone https://github.com/earendil-works/pi-mono
cd pi-mono
npm install
npm run build

Ejecutar desde el código fuente:

/path/to/pi-mono/pi-test.sh

El script puede ejecutarse desde cualquier directorio. Pi mantiene el directorio de trabajo actual del invocador.

Fork / Rebranding

Configura mediante package.json:

{
  "piConfig": {
    "name": "pi",
    "configDir": ".pi"
  }
}

Cambia los campos name, configDir y bin para tu fork. Afecta al banner del CLI, rutas de configuración y nombres de variables de entorno.

Resolución de rutas

Tres modos de ejecución: instalación npm, binario independiente, tsx desde el código fuente.

Usa siempre src/config.ts para recursos del paquete:

import { getPackageDir, getThemeDir } from "./config.js";

Nunca uses __dirname directamente para recursos del paquete.

Comando de depuración

/debug (oculto) escribe en ~/.pi/agent/pi-debug.log:

• Líneas TUI renderizadas con códigos ANSI
• Últimos mensajes enviados al LLM

Pruebas

./test.sh                         # Ejecutar pruebas sin LLM (no requiere claves API)
npm test                          # Ejecutar todas las pruebas
npm test -- test/specific.test.ts # Ejecutar prueba específica

Estructura del proyecto

packages/
  ai/           # Abstracción de proveedores LLM
  agent/        # Bucle del agente y tipos de mensaje
  tui/          # Componentes de UI de terminal
  coding-agent/ # CLI y modo interactivo