Gestión de la interfaz y sesiones

Este capítulo describe el modelo organizativo de VelaTerm: la distribución de la ventana, la gestión del árbol, el comportamiento de las pestañas y los paneles divididos, los puntos de estado y el filtrado, el archivado, la búsqueda global y el guardado del espacio de trabajo al salir. Los demás capítulos parten de estos conceptos.

1. Distribución de la ventana

Acceso remoto y Conectar a servidor remoto están disponibles en la aplicación de escritorio; consulte Desarrollo y gestión remota. Comentarios abre la página de comentarios de VelaTerm en su navegador. En Windows y Linux, al pulsar Alt aparece una barra de menús con Archivo, Terminal y Ayuda.

Ambos paneles laterales se pueden ocultar con los botones de la barra de título y se puede cambiar su tamaño arrastrando sus bordes.

2. El árbol: proyectos, colecciones, grupos y sesiones

• Un proyecto es un directorio del disco y la raíz de un subárbol. Para crearlo, use «Crear proyecto» (crea una carpeta nueva), «Importar proyecto» (abre una carpeta existente, ⌘O) o «Clonar desde Git».
• Una colección es un contenedor de nivel superior sin carpeta, pensado para sesiones que no pertenecen a un único proyecto. Se crea con el botón «Nueva colección» de la parte inferior de la barra lateral.
• Un grupo es un nodo organizativo y se puede anidar a cualquier profundidad.
• Una sesión es la unidad de trabajo: un agente, una página de navegador o un terminal. Su directorio de trabajo es, de forma predeterminada, la raíz del proyecto y se puede cambiar en el formulario «Editar» de la sesión.

Al pasar el puntero sobre una fila aparece un botón ＋ («Nueva sesión» en proyectos y grupos, «Nueva sesión hija» en sesiones) y, en proyectos y grupos, un botón para crear un grupo nuevo.

La mayoría de las operaciones se encuentran en los menús contextuales:

Los menús de proyecto y de grupo empiezan por las opciones de creación:

• «Nueva página de navegador» (aplicación de escritorio) y «Nuevo terminal», que abre un terminal temporal en ese directorio (§5).
• Tres opciones directas «Nueva sesión de …» para los agentes usados recientemente y «Más sesiones de agente», que reúne todos los agentes, los preajustes guardados, «Nueva sesión de agente» (el selector con búsqueda) y «Nuevo con argumentos…».
• «Nueva sesión de worktree…» y «Nueva sesión de planificación/ejecución…»; consulte Creación de sesiones y colaboración en Git y Planificación y ejecución.
• «Importar sesiones…» (solo en proyectos) y «Reanudar sesión…»; consulte Sesiones del agente de IA §4.

A continuación, el menú de proyecto ofrece «Nuevo grupo», «Marca», «Experimental» (Grafo de código y Auditoría de código), «Información del proyecto» (o «Información de la colección»), «Renombrar» y «Quitar proyecto» (o «Eliminar colección»). El menú de grupo ofrece el submenú «Git», «Nuevo subgrupo», «Mover a un worktree…», «Marca», «Renombrar», «Archivar grupo» y «Eliminar grupo».

Los menús de sesión muestran las opciones que corresponden al tipo y al estado de la sesión:

• «Abrir», «Abrir en pestaña nueva», «Abrir en división a la derecha», «Abrir en división abajo», «Abrir en el panel activo» (§4).
• «Nueva sesión hija», «Bifurcar sesión», «Exportar sesión…», «Organizar en la base de conocimientos de sesiones» y el submenú «Git».
• «Marca», «Información de sesión» (mantenga pulsada la tecla Option/Alt para ver el comando de inicio completo), «Editar», «Renombrar», «Mover a…».
• «Terminar proceso» (mientras está en ejecución), «Archivar sesión», «Eliminar sesión».

Otras operaciones del árbol:

• Mover: arrastre los nodos o use «Mover a…». Una sesión se puede mover debajo de otra sesión para convertirse en su sesión hija.
• Renombrar: «Renombrar» permite editar el nombre directamente en el árbol. Si no asigna un nombre a una sesión, esta toma el nombre de su primer mensaje.
• Marcas: «Marca» añade un marcador emoji a un proyecto, un grupo o una sesión: 🔥 Urgente, ⭐ Importante, 🐛 Error, ✅ Hecho, 🚧 En curso, 📌 Fijado, 💡 Idea, ⚠️ Precaución. Si vuelve a elegir el marcador actual, este se quita.
• Selección múltiple: ⌘/Ctrl+clic añade o quita sesiones de la selección, y Shift+clic selecciona un intervalo. El menú contextual ofrece entonces «Abrir sesiones seleccionadas», «Organizar sesiones seleccionadas en mosaico» (de dos a cuatro sesiones), «Mover selección a…», «Archivar sesiones seleccionadas» y «Eliminar N elementos seleccionados». Al arrastrar una selección, se mueve completa.
• El estado contraído o expandido de los nodos se conserva entre reinicios.

3. Pestañas

Ajustes ▸ Comportamiento ▸ «Pestañas» determina cómo se abren las sesiones:

• Única (predeterminado): al hacer clic en una sesión de agente del árbol se reutiliza la pestaña de sesión actual, igual que al seguir un enlace en un navegador. La pestaña que deja pasa a segundo plano con todos sus paneles, y sus procesos siguen ejecutándose. Las sesiones de terminal se abren en pestañas propias.
• Múltiples: cada sesión se abre en su propia pestaña.

«Abrir en pestaña nueva» siempre abre una pestaña nueva. En ambos modos, cambiar a otra pestaña no detiene nada; al cerrar una pestaña (⌘W o ×) se terminan sus procesos. En las sesiones de agente esto no supone ningún riesgo: la conversación se conserva y, al volver a abrir el nodo, se reanuda.

Las pestañas en segundo plano aparecen en la barra de estado como «Fondo N/M»; haga clic en este elemento para recuperar una pestaña o terminarla. En el modo Única, «Background limit» (32 de forma predeterminada) limita su número. Cuando se supera el límite, la pestaña en segundo plano inactiva más antigua se termina automáticamente. Si todas las pestañas en segundo plano están trabajando o esperando su intervención, VelaTerm le pregunta cuál desea terminar.

Detalles de la barra de pestañas:

• ⌘1–9 (Ctrl+1–9 en Windows y Linux) cambia a una pestaña según su posición. Un clic con el botón central cierra una pestaña.
• El ＋ situado a continuación de las pestañas abre un terminal temporal. Los botones de la derecha abren un terminal nuevo, un documento nuevo, una pestaña del navegador integrado (aplicación de escritorio) y el Centro de juegos.
• El menú contextual de una pestaña incluye «Cerrar pestaña», «Cerrar otras pestañas», «Cerrar pestañas a la derecha», «Cerrar todas las pestañas», «Enviar al segundo plano» (los procesos de la pestaña siguen en ejecución) y las mismas opciones de sesión que el árbol.

Las pestañas de documento y de navegador se describen en Pestañas de documentos y navegador.

4. Paneles divididos

Una pestaña puede contener varios paneles:

• ⌘D divide a la derecha y ⌘⇧D divide hacia abajo (Ctrl+Alt+D y Ctrl+Alt+E en Windows y Linux); el encabezado del panel incluye los mismos botones. El panel nuevo es un terminal temporal que se inicia en el directorio de trabajo del panel actual.
• Para mostrar una sesión existente en la pestaña actual, use «Abrir en división a la derecha», «Abrir en división abajo» o «Abrir en el panel activo» en su menú, o arrástrela desde la barra lateral hasta el panel central.
• «Organizar sesiones seleccionadas en mosaico» dispone de dos a cuatro sesiones seleccionadas en una misma pestaña.
• Las sesiones que se muestran en otro panel de la pestaña actual aparecen resaltadas en la barra lateral.

Los divisores se pueden arrastrar. El mantenimiento en segundo plano se aplica a toda la pestaña, de modo que, si sale de una pestaña y vuelve a ella, su disposición se conserva. ⌘W cierra el panel actual; al cerrar el último panel se cierra la pestaña.

5. Terminales temporales

«Nuevo terminal», ⌘T y el ＋ de la barra de pestañas abren un terminal temporal. Solo existe como pestaña: nunca se convierte en un nodo del árbol y se descarta al cerrarlo. La pestaña lleva la marca «temp». Use los terminales temporales para comandos rápidos y reserve las sesiones de agente para el trabajo de larga duración. El menú de un terminal temporal es breve: «Abrir», «Abrir en pestaña nueva», las opciones de división, «Renombrar», «Información de sesión» y «Cerrar borrador».

6. Puntos de estado y filtrado

El punto situado junto a cada sesión de agente indica su estado: verde mientras trabaja, amarillo cuando requiere su intervención y magenta cuando ha respondido y usted ya lo ha visto. La leyenda completa se encuentra en Sesiones del agente de IA §3.

La barra de estado muestra cuántas sesiones están «En curso», «Pendiente» (requieren su intervención) y «Visto»; los contadores sin sesiones se ocultan. Haga clic en un contador para mostrar solo esas sesiones en la barra lateral; vuelva a hacer clic para quitar el filtro.

La barra lateral dispone de sus propias herramientas:

• El cuadro de búsqueda («Buscar sesiones / grupos…») filtra el árbol por nombre.
• El botón de filtro («Filtrar por estado») selecciona uno o varios estados y, por separado, un marcador.
• Un filtro de estado conserva las sesiones que coincidían en el momento de aplicarlo, para que la lista no cambie mientras trabaja. Con «Incorporación dinámica al filtro de estado» (Ajustes ▸ Comportamiento, activado de forma predeterminada), se añaden las sesiones que empiezan a coincidir. «Actualizar filtro de estado», en la parte inferior de la barra lateral, vuelve a comprobar todas las sesiones; «Actualizar estado», en el menú de una sesión, comprueba solo esa sesión.
• «Dividir la vista de árbol hacia abajo», en la parte inferior de la barra lateral, añade una segunda vista del árbol con su propia búsqueda y sus propios filtros; por ejemplo, una vista para las sesiones que requieren su intervención y otra para el árbol completo. Cada vista adicional se puede cerrar.

7. Panel derecho

• Files: el árbol de archivos del directorio de trabajo de la sesión. Haga doble clic en un archivo para abrirlo en una pestaña de documento.
• Info: detalles de la sesión, uso de la cuenta, el turno actual y el consumo de recursos; consulte Sesiones del agente de IA §8.
• Git: rama, cambios preparados y sin preparar, archivos sin seguimiento, creación de commits e historial de commits.
• Base de conocimientos: la base de conocimientos de sesiones, las sesiones archivadas y sus bases de conocimientos locales; consulte Bases de conocimientos locales y Base de conocimientos de sesiones.

8. Archivado: guardar sin eliminar

No es necesario eliminar el trabajo terminado. Haga clic con el botón derecho en una sesión → «Archivar sesión» para ocultarla: la sesión y sus sesiones hijas salen del árbol y sus procesos terminan, pero todos los datos se conservan. «Archivar grupo» archiva todas las sesiones de un grupo, y «Archivar sesiones seleccionadas» archiva una selección.

Las sesiones archivadas se encuentran en la base de conocimientos. Ábralas con el botón «Sesiones archivadas» del encabezado de la barra lateral. Las sesiones archivadas se agrupan por proyecto, y el cuadro de búsqueda («Buscar en archivadas…») busca en su contenido. Para cada sesión archivada:

• La conversación se puede leer. Las sesiones de agente muestran sus mensajes; si no hay ninguna conversación disponible, se muestra la grabación del terminal, si existe. Una segunda pestaña enumera los artículos de conocimiento generados a partir de la sesión.
• «Restaurar como sesión normal» la devuelve a su lugar en el árbol con su ID de conversación intacto, de modo que al abrirla se reanuda la conversación original.
• «Organizar en la base de conocimientos de sesiones» extrae de ella conocimiento reutilizable.
• «Exportar contexto completo como Markdown» (Claude y Codex) escribe la conversación completa en un archivo.
• «Eliminar permanentemente (incluida la grabación)» es la única acción que borra los datos.

9. Búsqueda global (⌘⇧F)

«Buscar en todas las sesiones» (⌘⇧F; Ctrl+Alt+G en Windows y Linux) busca en el contenido de todas las sesiones, es decir, en las conversaciones de los agentes y en la salida grabada de los terminales, y no solo en los nombres.

• Se pueden combinar varias palabras en cualquier orden; también se encuentran palabras parciales y texto en chino, japonés o coreano. Los resultados se ordenan por relevancia.
• Los resultados se agrupan por sesión a la izquierda; la vista previa de la derecha resalta la coincidencia actual. ↑/↓ y Enter recorren las coincidencias de todas las sesiones.
• «Abrir sesión» abre la sesión en el espacio de trabajo.
• Las sesiones archivadas se excluyen, salvo que marque «Incluir archivadas».

La salida de los terminales solo se puede buscar cuando la grabación de sesiones está activada (Ajustes ▸ Avanzado ▸ «Registrar registros de sesión», desactivado de forma predeterminada). Las conversaciones de los agentes siempre se pueden buscar.

10. Eliminar con seguridad

Al eliminar una sesión, esta se borra de forma permanente junto con su grabación. Si elimina un grupo o un proyecto que contiene sesiones archivadas, esas sesiones archivadas se conservan y, al restaurar una de ellas, se recuperan también su proyecto y su grupo. Ante la duda, archive primero: el contenido archivado siempre se puede restaurar.

11. Salir y restaurar el espacio de trabajo

Al salir, VelaTerm pregunta «¿Salir de VelaTerm?» y detiene las sesiones de terminal y de agente en ejecución. Si marca «Guardar espacio de trabajo», el siguiente inicio vuelve a abrir las mismas pestañas y divisiones. Las sesiones restauradas no se inician por sí solas: cada panel muestra «Restaurado desde el espacio de trabajo guardado. Todavía no hay ningún proceso en ejecución.» con un botón «Iniciar». La casilla recuerda su última elección.