Usando Pi

Esta página recopila detalles de uso diario que no caben en la página de inicio rápido.

La interfaz tiene cuatro áreas principales:

• Encabezado de inicio: atajos, cargados context files, prompt templates, habilidades y extensiones
• Mensajes: mensajes de usuario, respuestas del asistente, llamadas de herramientas, resultados de herramientas, notificaciones, errores y interfaz de usuario de extensión
• Editor - donde escribes; El color del borde indica el nivel de pensamiento actual.
• Pie de página: directorio de trabajo, nombre de la sesión, uso de token/caché, costo, uso de contexto y modelo actual. Los totales incluyen las respuestas del asistente, el uso informado por las herramientas y la generación de resúmenes.

El editor se puede reemplazar temporalmente por una interfaz de usuario integrada como /settings o por una interfaz de usuario de extensión personalizada.

Característica	Cómo
Referencia de archivo	Escriba @ para realizar una búsqueda aproximada de archivos de proyecto
Finalización del camino	Presione Tab para completar rutas
Entrada multilínea	Mayús+Entrar o Ctrl+Entrar en la Terminal de Windows
Copiar respuesta	Ctrl+X copia el último mensaje del asistente; en /tree, copia el mensaje seleccionado
Imágenes	Pegue con Ctrl+V, Alt+V en Windows o arrastre al terminal
Comando de shell	!command ejecuta y envía salida al modelo
Comando de shell oculto	!!command se ejecuta sin enviar salida al modelo
editor externo	Ctrl+G abre externalEditor, $VISUAL, $EDITOR, el Bloc de notas en Windows o nano en otro lugar

Consulte Keybindings para conocer todos los atajos y personalizaciones.

Escriba / en el editor para abrir la finalización de comandos. Extensions puede registrar comandos personalizados, las habilidades están disponibles como /skill:name y prompt templates se expanden a través de /templatename.

Dominio	Descripción
/login, /logout	Administrar credenciales de clave OAuth o API
/llama	Descargar, cargar y descargar modelos de enrutador llama.cpp
/model	Cambiar modelos
/scoped-models	Activar/desactivar modelos para el ciclo Ctrl+P
/settings	Nivel de pensamiento, tema, entrega de mensajes, transporte.
/resume	Pick de sesiones anteriores
/new	Iniciar una nueva sesión
/name <name>	Establecer el nombre para mostrar de la sesión
/session	Mostrar archivo de sesión, ID, mensajes, tokens y costo
/tree	Salta a cualquier punto de la sesión y continúa desde allí.
/trust	Guarde la decisión de confianza del proyecto para sesiones futuras
/fork	Crear una nueva sesión a partir de un mensaje de usuario anterior
/clone	Duplicar la rama activa actual en una nueva sesión
/compact [prompt]	Contexto compacto manualmente, opcionalmente con instrucciones personalizadas
/copy	Copiar el último mensaje del asistente al portapapeles
/export [file]	Exportar sesión a HTML o JSONL
/import <file>	Importar y reanudar una sesión desde un archivo JSONL
/share	Subir como GitHub privado con enlace HTML para compartir
/reload	Vuelva a cargar combinaciones de teclas, extensiones, habilidades, indicaciones, temas y context files
/hotkeys	Mostrar todos los atajos de teclado
/changelog	Mostrar historial de versiones
/quit	dejar pi

Puede enviar mensajes mientras el agente aún está trabajando:

• Introducir pone en cola un mensaje de dirección, entregado después de que el turno actual del asistente termina de ejecutar sus llamadas de herramienta.
• Alt+Intro pone en cola un mensaje de seguimiento, que se entrega después de que el agente finaliza todo el trabajo.
• Escape cancela y restaura los mensajes en cola en el editor.
• Alt+Arriba recupera los mensajes en cola y los envía al editor.

En Windows Terminal, Alt+Enter está en pantalla completa de forma predeterminada. Vuelva a asignarlo como se describe en Terminal setup si desea que pi reciba el acceso directo.

Configura la entrega en Settings con steeringMode y followUpMode.

Las sesiones se guardan automáticamente en ~/.pi/agent/sessions/, organizadas por directorio de trabajo.

pi -c                  # Continue most recent session
pi -r                  # Browse and select a session
pi --no-session        # Ephemeral mode; do not save
pi --name "my task"    # Set session display name at startup
pi --session <path|id> # Use a specific session file or session ID
pi --fork <path|id>    # Fork a session into a new session file

Comandos de sesión útiles:

• /session muestra el archivo de sesión actual y el ID.
• /tree navega por el archivo session tree y puede resumir las ramas abandonadas.
• /fork crea una nueva sesión a partir de un mensaje de usuario anterior.
• /clone duplica la rama activa actual en un nuevo archivo de sesión.
• /compact resume mensajes antiguos en contexto libre.

Consulte Sessions y Compaction para obtener más detalles.

Pi carga AGENTS.md o CLAUDE.md al inicio desde:

• ~/.pi/agent/AGENTS.md para instrucciones globales
• directorios principales, subiendo desde el directorio de trabajo actual
• el directorio actual

Si un directorio contiene AGENTS.override.md, Pi lo carga en lugar de AGENTS.md o CLAUDE.md de ese directorio. Los archivos de contexto de otros directorios todavía se superponen normalmente.

Utilice context files para convenciones, comandos, reglas de seguridad y preferencias del proyecto. Deshabilite la carga con --no-context-files o -nc.

Reemplace el mensaje predeterminado del sistema con:

• .pi/SYSTEM.md para un proyecto
• ~/.pi/agent/SYSTEM.md globalmente

Agregue al mensaje predeterminado sin reemplazarlo con APPEND_SYSTEM.md en ninguna ubicación.

En el inicio interactivo, pi pregunta antes de confiar en una carpeta de proyecto que contiene configuraciones, recursos o proyecto local del proyecto .agents/skills y no tiene ninguna decisión guardada para la carpeta o una carpeta principal en ~/.pi/agent/trust.json. Confiar en un proyecto permite a pi cargar recursos .pi/settings.json y .pi, instalar paquetes de proyecto faltantes y ejecutar extensiones de proyecto.

Antes de la decisión de confianza, pi carga solo context files, extensiones de usuario/globales y extensiones CLI -e para que puedan manejar el evento project_trust. Las extensiones locales del proyecto, las extensiones administradas por paquetes del proyecto y la configuración del proyecto se cargan solo después de que el proyecto sea confiable. Esta división también se aplica cuando se cambia a una sesión desde un cwd diferente cuya confianza no se ha resuelto en el proceso actual.

Los modos no interactivos (-p, --mode json y --mode rpc) no muestran un mensaje de confianza. Sin una decisión de confianza guardada aplicable, usan defaultProjectTrust de la configuración global: ask (predeterminado) y never ignoran esos recursos del proyecto, mientras que always confía en ellos. Pase --approve/-a o --no-approve/-na para anular la confianza del proyecto durante una ejecución.

Si no se aplica ninguna extensión o decisión guardada, defaultProjectTrust controla el comportamiento de reserva. Configúrelo en "ask", "always" o "never" en ~/.pi/agent/settings.json, o cámbielo con /settings.

Los comandos pi config y del paquete usan el mismo flujo de confianza del proyecto, excepto que pi update nunca lo solicita. Pase --approve para confiar en la configuración local del proyecto para un comando o --no-approve para ignorarlos.

Utilice /trust en modo interactivo para guardar una decisión de confianza del proyecto para sesiones futuras, incluida la confianza para la carpeta principal inmediata. Escribe solo ~/.pi/agent/trust.json; la sesión actual no se recarga, así que reinicie pi para que los cambios surtan efecto.

Utilice /export [file] para escribir una sesión en HTML.

Utilice /share para cargar una esencia GitHub privada con un enlace HTML para compartir.

Si utiliza pi para trabajos de código abierto y desea publicar sesiones para investigación de modelos, indicaciones, herramientas y evaluación, consulte badlogic/pi-share-hf. Publica sesiones en Hugging Face conjuntos de datos.

pi [options] [@files...] [messages...]

pi install <source> [-l]     # Install package, -l for project-local
pi remove <source> [-l]      # Remove package
pi uninstall <source> [-l]   # Alias for remove
pi update [source|self|pi]   # Update pi only, or one package source
pi update --all              # Update pi and packages; reconcile pinned git refs
pi update --extensions       # Update packages only; reconcile pinned git refs
pi update --models           # Refresh model catalogs only
pi update --self             # Update pi only
pi update --extension <src>  # Update one package
pi list                      # List installed packages
pi config                    # Enable/disable package resources

Estos comandos administran paquetes pi y pi update pueden actualizar la instalación de pi CLI. Para desinstalar pi, consulte Quickstart. pi config y los comandos del paquete del proyecto aceptan --approve/--no-approve para confiar o ignorar la configuración local del proyecto para un comando. pi update nunca solicita confianza en el proyecto.

Consulte Pi Packages para conocer los orígenes de los paquetes y las notas de seguridad.

Bandera	Descripción
por defecto	Modo interactivo
-p, --print	Imprimir respuesta y salir
--mode json	Muestra todos los eventos como JSON líneas; ver JSON mode
--mode rpc	RPC modo terminado stdin/stdout; ver RPC mode
--export <in> [out]	Exportar una sesión a HTML

En el modo de impresión, pi también lee canalizado stdin y lo combina con el mensaje inicial:

cat README.md | pi -p "Summarize this text"

Opción	Descripción
--provider <name>	Proveedor, como anthropic, openai o google
--model <pattern>	Patrón de modelo o identificación; admite provider/id y opcional :<thinking>
--api-key <key>	API key, anulando variables de entorno
--thinking <level>	off, minimal, low, medium, high, xhigh, max
--models <patterns>	Patrones separados por comas para el ciclo Ctrl+P
--list-models [search]	Listar modelos disponibles

Opción	Descripción
-c, --continue	Continuar la sesión más reciente
-r, --resume	Navega y selecciona una sesión
`--sesión <ruta\	identificación>`
`--fork <ruta\	identificación>`
--session-dir <dir>	Directorio de almacenamiento de sesión personalizado
--no-session	Modo efímero; no guardar
--name <name>, -n <name>	Establecer el nombre para mostrar de la sesión al inicio

Opción	Descripción
--tools <list>, -t <list>	Herramientas integradas, de extensión y personalizadas específicas de la lista blanca
--exclude-tools <list>, -xt <list>	Deshabilite herramientas específicas integradas, de extensión y personalizadas
--no-builtin-tools, -nbt	Deshabilite las herramientas integradas pero mantenga habilitadas las herramientas de extensión/personalizadas
--no-tools, -nt	Deshabilitar todas las herramientas

Herramientas integradas: read, bash, edit, write, grep, find, ls.

Opción	Descripción
-e, --extension <source>	Cargue una extensión desde la ruta, npm o git; repetible
--no-extensions	Deshabilitar el descubrimiento de extensiones
--skill <path>	Cargar una habilidad; repetible
--no-skills	Deshabilitar el descubrimiento de habilidades
--prompt-template <path>	Cargue una plantilla de aviso; repetible
--no-prompt-templates	Deshabilitar el descubrimiento de plantillas de mensajes
--theme <path>	Cargar un tema; repetible
--no-themes	Deshabilitar el descubrimiento de temas
--no-context-files, -nc	Deshabilitar el descubrimiento AGENTS.md y CLAUDE.md

Combine --no-* con indicadores explícitos para cargar exactamente lo que necesita, ignorando la configuración. Ejemplo:

pi --no-extensions -e ./my-extension.ts

Opción	Descripción
--system-prompt <text>	Reemplazar mensaje predeterminado; context files y las habilidades aún están agregadas
--append-system-prompt <text>	Agregar al mensaje del sistema
--tui-mode <mode>	Modo TUI: regular (predeterminado) o experimental fullscreen
--verbose	Forzar inicio detallado
-a, --approve	Confíe en los archivos locales del proyecto para esta ejecución
-na, --no-approve	Ignorar archivos locales del proyecto para esta ejecución
-h, --help	Mostrar ayuda
-v, --version	Mostrar versión

En el modo fullscreen, la transcripción se desplaza dentro de la ventana gráfica del terminal mientras los mensajes en cola, el estado de trabajo, los widgets de extensión, el editor y el pie de página permanecen fijos en la parte inferior. La entrada del mouse/trackpad desplaza la región debajo del puntero; Las acciones de la ventana gráfica del teclado siempre permanecen disponibles. Las imágenes en línea funcionan en terminales que admiten el protocolo de gráficos Kitty, incluidos Kitty y Ghostty. En iTerm2, se representan como marcadores de posición de texto porque su protocolo de imágenes en línea no puede eliminar ni recortar ubicaciones durante el desplazamiento propiedad de la aplicación. En el modo regular, pi usa la pantalla principal y el desplazamiento hacia atrás propiedad del terminal, y las imágenes en línea de iTerm2 continúan representándose normalmente.

Configure TUI modo en /settings para cambiar entre regular y fullscreen inmediatamente y elija el modo predeterminado para sesiones futuras. Salida de salida en pantalla completa controla si al salir de la pantalla completa se imprime la transcripción final o se restaura la pantalla anterior e imprime solo la sugerencia de reanudación de la sesión.

Prefije los archivos con @ para incluirlos en el mensaje:

pi @prompt.md "Answer this"
pi -p @screenshot.png "What's in this image?"
pi @code.ts @test.ts "Review these files"

# Interactive with initial prompt
pi "List all .ts files in src/"

# Non-interactive
pi -p "Summarize this codebase"

# Non-interactive with piped stdin
cat README.md | pi -p "Summarize this text"

# Named one-shot session
pi --name "release audit" -p "Audit this repository"

# Different model
pi --provider openai --model gpt-4o "Help me refactor"

# Model with provider prefix
pi --model openai/gpt-4o "Help me refactor"

# Model with thinking level shorthand
pi --model sonnet:high "Solve this complex problem"

# Limit model cycling
pi --models "claude-*,gpt-4o"

# Read-only mode
pi --tools read,grep,find,ls -p "Review the code"

# Disable one extension or built-in tool while keeping the rest available
pi --exclude-tools ask_question

Pi mantiene el núcleo pequeño e introduce el comportamiento específico del flujo de trabajo en extensiones, habilidades, prompt templates y paquetes.

Intencionalmente no incluye MCP integrado, subagentes, ventanas emergentes de permiso, modo de plan, tareas pendientes o fondo bash. Puede crear o instalar esos flujos de trabajo como extensiones o paquetes, o utilizar herramientas externas como contenedores y tmux.

Para conocer el fundamento completo, lea el blog post.