Inicio rápido

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

Pi se distribuye como un paquete npm:

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

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

Usa el gestor de paquetes con el que instalaste pi. El instalador por curl usa npm de forma global, por lo que las instalaciones hechas con curl o npm se eliminan con npm:

# curl installer or 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

Al desinstalar pi, se conservan la configuración, las credenciales, las sesiones y los paquetes de pi instalados en ~/.pi/agent/.

Después, inicia pi en el directorio del proyecto en el que quieras que trabaje:

cd /path/to/project
pi

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

Inicia pi y ejecuta:

/login

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

Define una API key antes de iniciar pi:

export ANTHROPIC_API_KEY=sk-ant-...
pi

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

Consulta Providers para ver todos los proveedores admitidos, las variables de entorno y la configuración de proveedores cloud.

Cuando pi arranque, escribe una petición y pulsa Enter:

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

De forma predeterminada, pi proporciona cuatro herramientas al modelo:

• read - leer archivos
• write - crear o sobrescribir archivos
• edit - modificar archivos mediante patch
• bash - ejecutar comandos de Shell

Hay herramientas integradas adicionales de solo lectura (grep, find, ls) disponibles mediante las opciones de herramientas. Pi se ejecuta en tu directorio de trabajo actual y puede modificar archivos allí. Usa Git u otro flujo de checkpoints si quieres poder deshacer cambios fácilmente.

Pi carga context files al iniciar. Añade un archivo AGENTS.md para indicarle cómo debe 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 los directorios superiores y el directorio actual

Si un directorio contiene AGENTS.override.md, Pi carga ese archivo en lugar de AGENTS.md o CLAUDE.md desde ese directorio.

Reinicia pi o ejecuta /reload después de cambiar context files.

Escribe @ en el editor para buscar archivos de forma aproximada, 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"

Puedes pegar imágenes o texto con Ctrl+V (Alt+V en Windows); las imágenes también se pueden arrastrar a terminales compatibles.

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.

Usa /model o Ctrl+L para elegir un modelo. Usa Shift+Tab para alternar el thinking level. Usa Ctrl+P / Shift+Ctrl+P para recorrer los scoped models.

Las sesiones se guardan automáticamente:

pi -c                  # Continue most recent session
pi -r                  # Browse previous sessions
pi --name "my task"    # Set session display name at startup
pi --session <path|id> # Open a specific session

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

Para prompts de una sola ejecución:

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 emitir eventos JSON, o --mode rpc para integrarlo con otros procesos.

• Using Pi - modo interactivo, slash commands, sesiones, context files y referencia de 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, Skills, Prompts y Themes compartidos.

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