Inicio

Esta guía le acompaña desde la instalación hasta su primer terminal y su primera sesión de agente de IA. Basta para empezar a trabajar; cada función se describe en detalle en los demás capítulos (consulte el resumen del manual).

1. Qué es VelaTerm

VelaTerm es un gestor de terminales diseñado para trabajar con agentes de programación de IA. Organiza las sesiones de terminal y de agente en un árbol proyecto → grupo → sesión y ejecuta agentes de programación como Claude Code y Codex en sesiones dedicadas: en todo momento puede ver si un agente está trabajando, si requiere su intervención o si ha terminado, y al volver a abrir una sesión su conversación continúa. Los agentes pueden ejecutarse en su propia interfaz de terminal o en una vista de conversación con mensajes, tarjetas de herramientas y botones para responder a las solicitudes de permiso. El acceso remoto desde el navegador y el desarrollo remoto por SSH le permiten continuar sus sesiones desde otros dispositivos.

2. Instalación

Descargue el paquete para su plataforma desde la página de descarga:

VelaTerm busca actualizaciones automáticamente; la opción «Check for Updates…» del menú de la aplicación las busca de inmediato.

3. Primer inicio: añadir un proyecto

La primera vez que se inicia VelaTerm, la barra lateral está vacía y ofrece tres formas de añadir un proyecto:

• «Crear proyecto» crea una carpeta nueva y la añade.
• «Abrir proyecto» (⌘O; Ctrl+Alt+O en Windows y Linux) añade una carpeta existente.
• «Clonar desde Git» clona un repositorio y lo añade.

Las mismas acciones están disponibles como botones en el encabezado de la barra lateral. Dentro de un proyecto puede crear grupos, anidados con la profundidad que desee (por ejemplo, frontend, backend y pruebas), y sesiones dentro de ellos:

4. Abrir el primer terminal

Cualquiera de estas acciones abre un terminal temporal:

1. Pulse ⌘T (Ctrl+Alt+T en Windows y Linux).
2. Sitúe el puntero sobre un proyecto, un grupo o una sesión de la barra lateral, haga clic en el botón ＋ y elija «Nuevo terminal». El terminal se inicia en el directorio de ese nodo. Los menús contextuales de proyectos y grupos incluyen la misma opción.
3. Cuando el panel central está vacío, haga clic en «Crear terminal».

Los terminales temporales solo existen como pestañas: nunca se convierten en nodos del árbol y se descartan al cerrarlos, por lo que resultan adecuados para comandos rápidos.

5. Abrir la primera sesión de agente de IA

Haga clic con el botón derecho en un proyecto o un grupo y elija «Nueva sesión de Claude». El primer nivel del menú ofrece Claude, Codex y OpenCode; «Más sesiones de agente» muestra los catorce agentes compatibles. También puede pulsar ⌘N (Ctrl+Alt+N en Windows, en Linux y en navegadores convencionales) para abrir una lista de agentes con búsqueda.

VelaTerm inicia el agente en el directorio del proyecto. Las sesiones de Claude, Codex, OpenCode, Pi y OMP se abren en la vista de conversación: escriba su mensaje en el cuadro de la parte inferior y pulse Enter. Los demás agentes se abren en la vista de terminal, que muestra la interfaz de terminal propia del agente. El botón de cambio del encabezado del panel pasa una sesión de una vista a la otra; consulte Vista de conversación.

A partir de ese momento dispone de tres funciones:

• Puntos de estado: el punto situado junto a la sesión en la barra lateral indica el estado del agente. El verde significa que está trabajando; el amarillo, que requiere su intervención (una pregunta o una solicitud de permiso), y el magenta, que ha respondido y usted ya lo ha visto.
• Notificaciones del sistema: cuando el agente se detiene a la espera de su intervención, recibe una notificación. Si ya está viendo la sesión, no aparece ninguna notificación.
• Reanudación automática: si cierra la pestaña o sale de la aplicación, la próxima vez que abra la sesión la conversación continúa donde se quedó. Para empezar una conversación nueva, cree una sesión nueva.

Si la CLI del agente aún no está instalada, la sesión muestra una tarjeta de instalación con el comando de instalación recomendado para su sistema y un botón «Instalar ahora».

6. Recorrido rápido

• Barra lateral izquierda: el árbol de proyectos, con un cuadro de búsqueda y un filtro de estado. Botones del encabezado: Crear proyecto, Importar proyecto, Clonar desde Git, Buscar en todas las sesiones y Sesiones archivadas.
• Panel central: la barra de pestañas y las sesiones abiertas. De forma predeterminada, al hacer clic en una sesión de agente del árbol se reutiliza la pestaña actual, y la pestaña anterior sigue ejecutándose en segundo plano. Al cerrar una pestaña se terminan sus procesos. Las pestañas se pueden dividir en paneles (⌘D a la derecha, ⌘⇧D hacia abajo).
• Panel derecho: sigue a la sesión actual y tiene cuatro pestañas: Files, Info (detalles de la sesión, uso de la cuenta, contexto y consumo de recursos), Git (rama, cambios y commits) y Base de conocimientos.
• Barra de estado: número de sesiones, tipo de la sesión actual, rama de Git, modo de permisos, interruptor de notificaciones y los contadores En curso / Pendiente / Visto. Haga clic en un contador para mostrar solo esas sesiones en la barra lateral.
• Barra de título, lado derecho: selector de tema, Acceso remoto, Conectar a servidor remoto, Compartir, Ajustes, Cuenta, Comentarios y los botones que muestran u ocultan los paneles laterales.

7. Siguientes pasos

• Árbol, pestañas, paneles divididos, archivado y búsqueda global: Gestión de la interfaz y sesiones.
• Capacidades de los agentes, reanudación, bifurcación y permisos: Sesiones del agente de IA.
• Trabajo en la vista de conversación: Vista de conversación.
• Cómo permitir que los agentes inicien sesiones hijas en worktrees independientes: Creación de sesiones y colaboración en Git.
• Funciones del terminal (búsqueda, pegado de imágenes, sugerencias de comandos): Uso del terminal.
• Uso de VelaTerm desde un teléfono u otro ordenador: Desarrollo y gestión remota.