Pi.dev no tiene una sola forma de trabajar. La página oficial lista cuatro modos: interactive, print/JSON, RPC y SDK.
Interactive
Usa interactive cuando quieres conversar con el agente, revisar decisiones y corregirlo durante la sesión.
pi
Es el modo natural para tareas exploratorias: revisar un branch, entender un módulo, arreglar un test, o pedir un plan antes de tocar código.
Print / JSON
Usa print para scripts y automatizaciones simples:
Si tu pipeline consume eventos, revisa el modo JSON antes de parsear texto libre.
RPC
RPC sirve cuando quieres controlar Pi.dev desde otra aplicación que habla por stdin/stdout. Es útil si tu integración no vive en Node.js.
SDK
El SDK es la ruta para embeber Pi.dev en apps o herramientas propias. No empieces aquí si solo quieres aprender el agente; primero domina interactive y print.
Orden recomendado
Primero interactive, después print para tareas repetibles, y solo después RPC o SDK si ya tienes una integración real que mantener.