Inicio rápido

Esta página te lleva desde la instalación hasta una primera sesión útil de pi.

Instalación

Pi se distribuye como paquete npm:

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

--ignore-scripts desactiva los scripts del ciclo de vida de las dependencias durante la instalación. Pi no requiere scripts de instalación para instalaciones npm normales.

Desinstalación

Usa el gestor de paquetes que instaló pi. El instalador curl usa npm globalmente, así que las instalaciones curl y npm se eliminan con npm:

# instalador curl o npm install -g
npm uninstall -g @earendil-works/pi-coding-agent

# pnpm
pnpm remove -g @earendil-works/pi-coding-agent

# Yarn
yarn global remove @earendil-works/pi-coding-agent

# Bun
bun uninstall -g @earendil-works/pi-coding-agent

Desinstalar pi deja la configuración, credenciales, sesiones y paquetes pi instalados en ~/.pi/agent/.

Luego inicia pi en el directorio del proyecto en el que quieres que trabaje:

cd /path/to/project
pi

Autenticación

Pi puede usar proveedores de suscripción mediante /login, o proveedores con clave API mediante variables de entorno o el archivo auth.

Opción 1: inicio de sesión por suscripción

Inicia pi y ejecuta:

/login

Luego selecciona un proveedor. Los inicios de sesión por suscripción integrados incluyen Claude Pro/Max, ChatGPT Plus/Pro (Codex) y GitHub Copilot.

Opción 2: clave API

Establece una clave API antes de lanzar pi:

export ANTHROPIC_API_KEY=sk-ant-...
pi

También puedes ejecutar /login y seleccionar un proveedor de clave API para guardar la clave en ~/.pi/agent/auth.json.

Consulta Providers para todos los proveedores compatibles, variables de entorno y configuración de proveedores en la nube.

Primera sesión

Una vez que pi inicia, escribe una solicitud y pulsa Enter:

Summarize this repository and tell me how to run its checks.

Por defecto, pi proporciona al modelo cuatro herramientas:

• read - leer archivos
• write - crear o sobrescribir archivos
• edit - parchear archivos
• bash - ejecutar comandos shell

Las herramientas integradas de solo lectura adicionales (grep, find, ls) están disponibles mediante opciones de herramientas. Pi se ejecuta en tu directorio de trabajo actual y puede modificar archivos allí. Usa git u otro flujo de puntos de control si quieres revertir fácilmente.

Dar instrucciones de proyecto a pi

Pi carga archivos de contexto al iniciar. Añade un archivo AGENTS.md para indicarle cómo trabajar en un proyecto:

# Project Instructions

- Run `npm run check` after code changes.
- Do not run production migrations locally.
- Keep responses concise.

Pi carga:

• ~/.pi/agent/AGENTS.md para instrucciones globales
• AGENTS.md o CLAUDE.md desde directorios padre y el directorio actual

Reinicia pi o ejecuta /reload después de cambiar archivos de contexto.

Cosas comunes para probar

Referenciar archivos

Escribe @ en el editor para buscar archivos de forma difusa, o pasa archivos en la línea de comandos:

pi @README.md "Summarize this"
pi @src/app.ts @src/app.test.ts "Review these together"

Las imágenes se pueden pegar con Ctrl+V (Alt+V en Windows) o arrastrar en terminales compatibles.

Ejecutar comandos shell

En modo interactivo:

!npm run lint

La salida del comando se envía al modelo. Usa !!command para ejecutar un comando sin añadir su salida al contexto del modelo.

Cambiar modelos

Usa /model o Ctrl+L para elegir un modelo. Usa Shift+Tab para alternar el nivel de razonamiento. Usa Ctrl+P / Shift+Ctrl+P para alternar entre modelos con alcance.

Continuar más tarde

Las sesiones se guardan automáticamente:

pi -c                  # Continuar la sesión más reciente
pi -r                  # Explorar sesiones anteriores
pi --name "my task"    # Establecer nombre de sesión al iniciar
pi --session <path|id> # Abrir una sesión específica

Dentro de pi, usa /resume, /new, /tree, /fork y /clone para gestionar sesiones.

Modo no interactivo

Para prompts puntuales:

pi -p "Summarize this codebase"
cat README.md | pi -p "Summarize this text"
pi -p @screenshot.png "What's in this image?"

Usa --mode json para salida de eventos JSON o --mode rpc para integración de procesos.

Próximos pasos

• Using Pi - modo interactivo, comandos slash, sesiones, archivos de contexto y referencia CLI.
• Providers - autenticación y configuración de modelos.
• Settings - configuración global y de proyecto.
• Keybindings - atajos y personalización.
• Pi Packages - instalar extensiones, habilidades, prompts y temas compartidos.

Notas de plataforma: Windows, Termux, tmux, Terminal setup, Shell aliases.