Sesiones del agente de IA

Este capítulo describe cómo VelaTerm aloja los agentes de programación de IA como sesiones de un tipo determinado: agentes compatibles, estado en tiempo real, reanudación automática de conversaciones, importación y bifurcación de conversaciones, modos de permisos, ajustes de inicio, guía de instalación y el panel Info. La vista de conversación tiene su propio capítulo: Vista de conversación.

1. Agentes compatibles

VelaTerm puede iniciar estos agentes: Claude Code (se muestra como «Claude»), Codex, OpenCode, Copilot, Cursor, Antigravity, Cline, Pi, OMP, Crush, Kimi Code, Kiro, Grok Build y Zoo Code. La CLI de cada agente debe estar instalada y tener una sesión iniciada.

Las capacidades varían según el agente:

• La notifica el agente significa que el propio agente comunica a VelaTerm cuándo empieza a trabajar, cuándo requiere su intervención y cuándo termina, por lo que el estado es exacto. Codex notifica todas las fases cuando su versión admite hooks de ciclo de vida; las versiones anteriores de Codex solo notifican el final de cada turno. Cuando una fila muestra ✗ en la columna «Requiere su intervención», el agente no notifica sus preguntas ni sus solicitudes de permiso, por lo que la sesión figura como en curso hasta que termina el turno.
• Se lee de la pantalla significa que VelaTerm reconoce el estado del agente a partir de su interfaz de terminal.
• En Copilot, Cursor, Antigravity, Kimi Code, Kiro y Grok Build, VelaTerm añade sus propias entradas a la configuración de usuario del agente la primera vez que se inicia una sesión de ese agente. Estas entradas no tienen ningún efecto cuando el agente se ejecuta fuera de VelaTerm.
• Los agentes que usted inicia por su cuenta en un terminal normal no se ven afectados; la notificación del estado solo se aplica a las sesiones de agente que inicia VelaTerm.

2. Crear una sesión de agente

• Menú contextual. Haga clic con el botón derecho en un proyecto, un grupo o una sesión. El primer nivel del menú ofrece tres agentes: al principio, Claude, Codex y OpenCode, y más adelante, los tres tipos de agente con los que haya creado sesiones más recientemente. «Más sesiones de agente» muestra todos los agentes, sus preajustes guardados, «Nuevo con argumentos…» y «Nueva sesión de agente» (el selector con búsqueda).
• Selector de nueva sesión de agente. ⌘N en macOS (Ctrl+Alt+N en Windows, en Linux y en navegadores convencionales) abre una lista con búsqueda de agentes y preajustes, en la que las elecciones recientes llevan la marca «Último utilizado». Consulte Ajustes y atajos §9.
• Sesiones hijas. El submenú «Nueva sesión hija» de una sesión crea la nueva sesión debajo de ella. También se pueden iniciar sesiones desde una conversación; consulte Creación de sesiones y colaboración en Git.

Nuevo con argumentos… abre un cuadro de diálogo con el tipo de agente («Tipo de agente»), un nombre opcional («Nombre de sesión (vacío = automático)»), «Argumentos de inicio (opcional)», «Ejecutable (opcional)» para indicar un ejecutable alternativo que solo utiliza esta sesión, el ajuste de permisos, «Se abre en» («Vista de terminal» o «Vista de conversación») para los agentes que admiten ambas vistas y una opción «Worktree». «Guardar como preajuste» guarda la configuración con un nombre y, opcionalmente, un icono. Los preajustes aparecen en el menú y en el selector, y se inician con el ejecutable, los argumentos y el ajuste de permisos guardados.

Las sesiones de Claude, Codex, OpenCode, Pi y OMP se abren de forma predeterminada en la vista de conversación; los demás agentes se abren en la vista de terminal. Ajustes ▸ Agentes ▸ «Vista predeterminada» permite cambiarlo para cada agente.

3. Puntos de estado: quién trabaja y quién requiere su intervención

El punto situado junto a cada sesión de agente se actualiza en tiempo real:

Cuando un agente se detiene a la espera de su intervención (una pregunta, una solicitud de permiso o el final de un turno), usted recibe una notificación del sistema, la sesión se marca como no leída y el distintivo del Dock la contabiliza. Si ya está viendo esa sesión, no aparece ninguna notificación. En la compilación firmada para macOS, al hacer clic en una notificación se abre la sesión. El elemento «Notify: On/Off» de la barra de estado activa o desactiva las notificaciones del sistema; las marcas de no leído y los distintivos se mantienen. Cuando hay distintivos, el encabezado de la barra lateral muestra un botón que los borra todos.

Los contadores «En curso», «Pendiente» y «Visto» de la barra de estado filtran la barra lateral para mostrar las sesiones en ese estado; consulte Gestión de la interfaz y sesiones §6.

4. Reanudación automática: se cierra, se vuelve a abrir y la conversación continúa

La idea clave, en una línea: cada nodo de sesión de agente del árbol es una conversación en curso.

• En la primera ejecución, VelaTerm guarda el ID de conversación propio del agente.
• A partir de entonces, tanto si cerró la pestaña como si salió de la aplicación, al volver a abrir el nodo continúa la misma conversación. Antes de reanudarla, VelaTerm comprueba que la conversación siga existiendo; si se eliminó, la sesión empieza de cero en lugar de fallar.
• Para empezar una conversación nueva, cree un nodo de sesión nuevo. En la vista de conversación, /clear sustituye la sesión por otra nueva y vacía en el mismo lugar.

Reanudar sesión…, al final del menú Nueva sesión, añade una conversación que ya tiene; por ejemplo, una que ejecutó en un terminal normal. Elija el «Tipo de agente», pegue el ID de conversación del agente y elija «Reanudar y abrir». Todos los tipos de agente del §1 se pueden reanudar de esta forma.

Importar sesiones…, en el menú contextual de un proyecto, enumera las conversaciones existentes de Codex, Claude, OpenCode y Kiro cuyo directorio de trabajo coincide exactamente con el directorio del proyecto. Busque por título, agente o ID de sesión («Buscar por título, agente o ID de sesión»), seleccione las filas y elija «Importar». Las conversaciones se incorporan al árbol del proyecto; abra una para continuarla. La importación no copia ni modifica el historial propio del agente. Las conversaciones que ya están en VelaTerm, incluidas las archivadas, llevan la marca «Ya importada». Las conversaciones de subdirectorios o de worktrees independientes solo aparecen cuando ese directorio se abre como proyecto propio. El historial de Kiro se puede consultar si sus registros solo contienen texto. Cuando está conectado a un VelaTerm remoto, la lista procede del ordenador remoto.

5. Bifurcar: crear una rama a partir de una conversación

En las sesiones de Claude, Codex, Pi y OMP que ya tienen una conversación, haga clic con el botón derecho → «Bifurcar sesión». Se crea un nodo hermano que parte del historial actual de la conversación de origen y deja el origen sin cambios, de forma similar a una rama de git. Úselo para probar dos enfoques a partir del mismo contexto.

6. Permisos

Los ajustes de permisos determinan cuánto puede hacer el agente sin preguntarle.

• Claude, Codex y OpenCode tienen modos con nombre. Claude: «Modo plan», «Preguntar siempre», «Aceptar ediciones», «Modo automático», «Sin preguntar». Codex: «Solo lectura», «Modo automático», «Acceso total». OpenCode: «Preguntar siempre», «Sin preguntar».
• Copilot, Cursor, Antigravity, Cline, OMP, Crush, Kimi Code, Kiro, Grok Build y Zoo Code tienen un único interruptor, «Omitir todas las confirmaciones de permiso», que inicia el agente con su propia opción para omitir las confirmaciones. En la vista de conversación, OMP ofrece «Preguntar siempre» y «Sin preguntar».
• Pi ejecuta las herramientas sin preguntar, por lo que no tiene ajuste de permisos.

Dónde se cambia:

• Para una sesión: en el formulario «Editar» de la sesión («Permiso» o la casilla «Omitir todas las confirmaciones de permiso»); en la vista de terminal, en el elemento de permisos de la barra de estado («Permisos: Preguntar» / «Permisos: Omitir» o el nombre del modo actual); en la vista de conversación, en el control de permisos situado bajo el cuadro de mensaje.
• Valor predeterminado para las sesiones nuevas: Ajustes ▸ Agentes ▸ «Permiso». Los menús de la barra de estado y de la vista de conversación también ofrecen «Predeterminado».

Algunos cambios solo se aplican después de reiniciar el agente. En ese caso, VelaTerm ofrece «Reiniciar ahora» o «Más tarde»; el reinicio reanuda la conversación, pero interrumpe la tarea en curso. «Sin preguntar», «Acceso total» y «Omitir todas las confirmaciones de permiso» omiten todas las confirmaciones, así que úselos con precaución.

7. Ajustes de inicio y guía de instalación

Argumentos de inicio. El formulario «Editar» de la sesión incluye «Argumentos de inicio (opcional)», que añade argumentos de línea de comandos para esa sesión. Ajustes ▸ Agentes guarda un valor predeterminado para cada tipo de agente.

Ruta del ejecutable. Si un agente está instalado fuera de su PATH, indique su «Ruta del ejecutable (opcional)» en Ajustes ▸ Agentes. Si el campo está vacío, el comando se busca en el PATH.

¿No está instalado? Al iniciar un agente que no está instalado, la sesión muestra una tarjeta, «<Agent> no está instalado», con el comando de instalación recomendado para su sistema.

• «Instalar ahora» ejecuta el comando en la sesión. Cuando se encuentra el programa instalado, su ruta se guarda en Ajustes y un cuadro de diálogo ofrece «Reiniciar ahora» o «Más tarde».
• «Reintentar» vuelve a iniciar la sesión; por ejemplo, después de que usted haya instalado el agente por su cuenta.
• Si el agente ya está instalado fuera del PATH, escriba la ruta completa en «Ruta del ejecutable» y elija «Usar esta ruta», o use «Examinar…».
• «Documentación» abre la documentación de instalación del agente; «Lo haré yo mismo» cierra la tarjeta.

Después de la instalación, cada agente sigue necesitando su propio inicio de sesión o su propia clave de API.

8. El panel Info: uso, contexto y recursos

Con una sesión de agente abierta, la pestaña Info del panel derecho muestra lo siguiente:

• Agent: el tipo de agente, el nombre de la sesión, el directorio de trabajo, la rama de Git, la hora de inicio y el tiempo de actividad. En las sesiones de Kiro, incluye además un enlace a una vista de solo lectura del historial de la conversación.
• Usage (Claude, Codex, Grok Build): el consumo de la cuota de la cuenta, por ejemplo en las ventanas de cinco horas y de siete días, con sus horas de restablecimiento. El botón ↻ actualiza los datos de inmediato. La actualización automática y su intervalo se configuran en Ajustes ▸ Comportamiento («Usage auto-refresh», «Usage refresh»). Si una actualización falla, los últimos valores siguen visibles con la marca «stale».
• This turn (Claude, Codex, Grok Build, OpenCode, Pi, OMP, Kiro): el modelo, el grado de ocupación de la ventana de contexto y los recuentos de tokens y las herramientas del turno actual.
• Resources: CPU y memoria de los procesos de la sesión; la opción «system» añade las cifras de todo el ordenador.

9. Transcripciones, exportación y archivado

• Clic con el botón derecho → «Exportar sesión…» (Claude y Codex, cuando ya existe una conversación) escribe la conversación completa en un archivo Markdown, incluidos el razonamiento y cada llamada a herramientas con su entrada y su resultado.
• «Organizar en la base de conocimientos de sesiones», en el menú de la sesión, hace que un agente extraiga conocimiento reutilizable de la conversación; consulte Base de conocimientos de sesiones.
• Las sesiones archivadas se pueden leer en la vista «Sesiones archivadas» de la base de conocimientos. Las conversaciones de Claude, Codex, OpenCode, Pi, OMP, Grok Build y Kiro se muestran como mensajes; en los demás agentes se muestra la grabación del terminal, si existe. Al restaurar una sesión archivada se conserva su ID de conversación, por lo que se reanuda de la forma habitual. Consulte Gestión de la interfaz y sesiones §8.

10. Otros comportamientos

• Nombres automáticos: una sesión a la que no ha asignado un nombre toma el nombre de su primer mensaje.
• Cambios de tema: al cambiar entre el tema claro y el oscuro, las sesiones de Claude en ejecución en la vista de terminal se actualizan sin necesidad de reiniciarlas.
• Vela Skills: Ajustes ▸ General ▸ «Vela Skills» instala habilidades para Claude Code y Codex que inician sesiones hijas, abren archivos y leen otras sesiones o les envían mensajes; consulte Comandos de sesión.
• Windows: Claude Code y Codex son totalmente compatibles (se ejecutan en PowerShell); los demás agentes se admiten en la medida de lo posible.