Asistente

El Asistente es un panel a la derecha de la ventana donde se ejecuta tu agente de código: Claude Code, Codex, OpenCode o Cursor, en una terminal real, abierta en la carpeta del proyecto. Selecciona un error en un log de Joppa y le llega con todo su contexto.

Abrir el panel

⌘ I abre o cierra el Asistente desde cualquier pantalla (también en la paleta ⌘ K: Asistente). Sin sesión, ofrece los agentes instalados y Terminal, tu shell. La sesión se abre en la carpeta del proyecto en pantalla, mostrada bajo las pestañas; sin proyecto, en tu carpeta personal.

• +: una nueva sesión, de un agente o de la terminal. Cada sesión tiene su pestaña; × la cierra y detiene el programa.
• Relanzar: cuando el agente se ha detenido, vuelve a arrancar en la misma carpeta.
• Redimensionar: arrastra el borde izquierdo del panel. Joppa recuerda el ancho.

Las sesiones siguen en marcha cuando cambias de pantalla o cierras el panel.

Los agentes ofrecidos

Joppa solo ofrece los agentes que encuentra en el PATH de tu shell de inicio de sesión (y en sus carpetas de instalación habituales, como ~/.local/bin o ~/.opencode/bin):

Agente	Comando
Claude Code	claude
Codex	codex
OpenCode	opencode
Cursor	cursor-agent

Un agente instalado mientras Joppa se ejecuta aparece la próxima vez que se abre el panel.

Enviar un error

Selecciona líneas en la terminal integrada o en el registro de un servicio. Aparece una burbuja encima:

• Preguntar a Claude Code (el agente por defecto); la flecha de al lado ofrece los demás agentes instalados y Terminal.
• Copiar con el contexto: pone lo mismo en el portapapeles, para pegarlo donde quieras (Claude en la web, Cursor…).

Joppa abre el agente en la carpeta correcta, o reutiliza la sesión de ese agente ya abierta en esa carpeta, y escribe la pregunta en su prompt. Dice claramente de dónde vienen las líneas:

• para un proceso: el proyecto, la ruta completa de su carpeta, el proceso, su comando, la carpeta donde se ejecuta, su puerto, su estado y su código de salida; en la pestaña Todos, que cada línea empieza por su proceso;
• para un servicio: el servicio, su contenedor y su puerto, la base de datos de la pestaña elegida y los proyectos que lo usan con su ruta completa. El agente se abre en la carpeta del proyecto que usa esa base (o del único proyecto que usa el servicio).

Después vienen las líneas seleccionadas y una primera pregunta («¿Qué falla y cómo lo corrijo?») que puedes reescribir.

Permitir un agente

La primera vez que Joppa abre un agente, pregunta ¿Permitir que Joppa abra Claude Code?, con la ruta del comando. El agente podrá leer y modificar los archivos de la carpeta, como en tu terminal.

La casilla Enviar directamente las preguntas hechas desde Joppa está sin marcar: Joppa escribe la pregunta en el prompt sin pulsar Intro. La relees, la completas y la envías. Marcada, Joppa pulsa Intro por ti. La terminal nunca envía nada por sí sola.

Ajustes

El botón ⚙ del panel ajusta el Agente por defecto y Enviar directamente las preguntas, y lleva a Todos los ajustes…. Ajustes › Asistente recoge esas dos opciones y lista los Agentes permitidos, cada uno con Quitar: Joppa volverá a preguntar la próxima vez. Consulta Ajustes.