Pi coding agent: instalación, login y primera tarea

Respuesta rápida

Pi en CodeAgentSwarm, en imágenes

El selector muestra el modelo y su proveedor. Puedes revisar esa conexión sin salir del proyecto, mientras Chat conserva los mensajes y las herramientas de la tarea.

Una primera tarea que puedes comprobar

Usa un repositorio pequeño que conozcas. Empieza pidiendo a Pi que lea el README y el manifiesto del paquete, identifique el comando de pruebas y explique el proyecto sin modificar archivos. Así compruebas que trabaja en la carpeta correcta antes de pedir cambios.

Lee README.md y package.json. Explica qué hace este proyecto
y cómo ejecutar sus pruebas en tres puntos breves. No cambies archivos.

Después pide un cambio con una condición de aceptación, por ejemplo añadir una prueba para mover una tarea a Hecho. Revisa los archivos modificados y ejecuta el comando de pruebas real. Una respuesta terminada en Chat no equivale a unas pruebas correctas.

Qué es Pi y qué hace el harness

Un harness proporciona el entorno de trabajo que rodea al modelo: conversación, contexto del proyecto y herramientas. En Pi, una petición puede llevar a leer archivos, editar código y ejecutar un comando. El resultado depende del modelo seleccionado y de las instrucciones y herramientas disponibles.

Puedes ampliar Pi con skills, plantillas de prompts y extensiones. Su flujo integrado no incluye un modo plan nativo ni un gestor de subagentes. Esa diferencia importa al compararlo con OpenCode. Presentación de Pi.

Instalar Pi en macOS o Linux

Usa Node.js 22.19.0 o posterior para la versión de Pi verificada por CodeAgentSwarm, la 0.85.1. Comprueba las versiones de Node y npm antes de instalar el paquete actual. Algunos tutoriales antiguos utilizan el nombre anterior del paquete, @mariozechner.

node --version
npm --version
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
pi --version

Ejecuta los comandos en un shell del sistema y abre Pi desde la carpeta de un proyecto. Para PowerShell y la herramienta de comandos, consulta la guía de Windows.

Conectar un proveedor y probar una tarea pequeña

cd /ruta/a/tu/proyecto
pi

• Dentro de Pi, escribe /login y completa el inicio de sesión del proveedor elegido.
• Escribe /model y elige un modelo al que tu cuenta tenga acceso.
• Empieza con una petición acotada: "Lee este proyecto y dime qué comando ejecuta sus pruebas. No cambies archivos".
• Para la siguiente tarea, pide un cambio concreto, revisa el diff y ejecuta la comprobación correspondiente.

El login con suscripción y una clave API pueden tener facturación distinta. Consulta la guía de modelos y suscripciones antes de elegir proveedor.

Retomar una conversación o repartir el trabajo

Pi guarda las sesiones en ~/.pi/agent/sessions/. Usa su selector para retomar trabajo anterior sin pegar toda la conversación en un chat nuevo.

pi -c
# O elige una sesión anterior
pi -r

Dos procesos de Pi pueden trabajar de forma independiente, pero si editan el mismo checkout comparten los archivos. Usa Git worktrees separados cuando sus cambios puedan coincidir. Separar conversaciones no aísla el sistema de archivos.

Pi en CodeAgentSwarm: estado de la beta

La integración de Pi está en pruebas beta. Todavía no se anuncia como disponible en la descarga pública estándar. Una compilación beta verificada muestra Pi en Chat y CLI, con streaming, selección de modelo, decisiones de permisos, historial y reanudación.

La integración usa el modo RPC nativo de Pi. En la beta, inicia sesión desde su vista CLI y abre un nuevo Chat de Pi para cargar los modelos disponibles. Las credenciales existentes de Codex y Claude CLI no se copian a Pi.

El mismo controlador se ha comprobado en el paquete de CAS Cloud. La autenticación pertenece al equipo que ejecuta Pi; configurar tu Mac no inicia sesión en un servidor remoto. Consulta el protocolo RPC de Pi para conocer la integración.