Manual del usuario de VelaTerm
Este es el manual del usuario de VelaTerm. Si empieza a usar VelaTerm, lea los cuatro primeros capítulos en orden y consulte los demás cuando los necesite.
Orden de lectura
| # | Capítulo | Contenido | Destinatarios |
|---|---|---|---|
| 1 | Inicio | Instalación, cómo añadir un proyecto, el primer terminal y la primera sesión de agente, recorrido por la ventana | Todos los usuarios nuevos; empiece por aquí |
| 2 | Gestión de la interfaz y sesiones | Distribución de la ventana, el árbol de proyectos y sus menús, colecciones, marcas, pestañas y pestañas en segundo plano, paneles divididos y disposición en mosaico, filtros de estado, archivado, búsqueda global, guardado del espacio de trabajo | Todos los usuarios |
| 3 | Sesiones del agente de IA | Los catorce agentes compatibles y sus capacidades, puntos de estado y notificaciones, reanudación, importación y bifurcación de conversaciones, permisos, preajustes, guía de instalación, el panel Info | Quienes trabajan con agentes de programación de IA |
| 4 | Vista de conversación | Cambio entre la vista de terminal y la vista de conversación, envío de mensajes mientras el agente trabaja (cola, indicaciones durante el turno, interrupción), controles de modelo, esfuerzo y permisos, imágenes, comandos, retroceso, tareas en segundo plano, continuación automática tras los límites de uso, inicio de sesión | Usuarios de Claude Code, Codex, OpenCode, Pi y OMP |
| 5 | Creación de sesiones y colaboración en Git | Inicio de sesiones hijas con vspawn, la tarjeta de confirmación, worktrees, el menú Git y la fusión gráfica | Trabajo en paralelo con varios agentes |
| 6 | Planificación y ejecución | Flujos de trabajo de planificación y ejecución, división del trabajo en varias tareas revisadas, modos de directorio, seguimiento del progreso | Tareas de mayor envergadura que requieren planificación y revisión |
| 7 | Comandos de sesión | Referencia de los diez comandos integrados (vspawn, vspawn-tree, vopen, vrefer, vsearch, vstat, vtell, vrun, vkb, vflow), las Vela Skills, incluida vask, y el comando de shell vela | Consulta para usuarios y scripts |
| 8 | Uso del terminal | Conceptos básicos del terminal, búsqueda en el terminal, copiar y pegar, pegado de imágenes, sugerencias de comandos, los comandos integrados y los comandos vrun en segundo plano, selección de shell en Windows, grabación de sesiones, opciones de renderizado, atajos habituales | Todos los usuarios |
| 9 | Sugerencias de comandos | Sugerencias basadas en el autocompletado propio de la shell en los terminales normales: ajustes y controles, shells compatibles, cómo se carga la integración, situación actual en Windows, limitaciones | Usuarios del terminal en macOS y Linux |
| 10 | Pestañas de documentos y navegador | Pestañas de documento (apertura de archivos, el editor Markdown, edición y guardado, documentos nuevos y exportación a PDF), pestañas de navegador en la aplicación de escritorio y convivencia de los distintos tipos de pestaña | Según sea necesario |
| 11 | Bases de conocimientos locales | Carpetas de Markdown como bases de conocimientos: apertura o creación, importación de archivos y carpetas, redacción y organización de notas, búsqueda, enlaces, copia desde la base de conocimientos de sesiones, almacenamiento | Toma de notas y documentación |
| 12 | Base de conocimientos de sesiones | Organización del conocimiento procedente de las sesiones, historial de organización, consulta y mantenimiento de artículos, sesiones archivadas, vínculos con el grafo de código | Conservación de las decisiones y lecciones del trabajo con agentes |
| 13 | Grafo de código y base de conocimientos | Indexación del código de un proyecto, consulta de los símbolos y sus relaciones, vinculación y revisión de artículos de conocimiento, consultas desde una sesión, ubicación de los datos (experimental) | Exploración del código |
| 14 | Auditorías de código | Auditorías de seguridad de un proyecto con Codex o Claude Code: modelos y esfuerzo de razonamiento, integración con Codex Security, alcance, informes, exportaciones (experimental) | Revisiones de seguridad |
| 15 | Ajustes y atajos | Todos los elementos de las ocho categorías de ajustes, combinaciones de teclas predeterminadas y su reasignación, el selector de nueva sesión de agente | Consulta |
| 16 | Desarrollo y gestión remota | Acceso remoto para otros dispositivos, conexión a otras máquinas por SSH (incluidos equipos Windows y el reflejo de la aplicación de escritorio remota), mediante una URL o con su cuenta, uso compartido mediante una cuenta de VelaTerm (experimental), transferencia de archivos, uso de VelaTerm en un teléfono, desconexión y qué se conserva, seguridad | Uso remoto y desde dispositivos móviles |
¿Busca los cambios de cada versión? Consulte el Registro de cambios.
Cuatro ideas que conviene conocer primero
- Cada sesión de agente del árbol es una conversación en curso. Si la cierra y la vuelve a abrir, la conversación continúa. Para empezar una conversación nueva, cree una sesión nueva.
- Las pestañas funcionan como en un navegador. De forma predeterminada, al abrir una sesión de agente se reutiliza la pestaña actual, y la pestaña que deja sigue ejecutándose en segundo plano. Al cerrar una pestaña se terminan sus procesos, pero incluso entonces la conversación de un agente se puede reanudar.
- Una conversación, dos vistas. Claude Code, Codex, OpenCode, Pi y OMP pueden ejecutarse en la vista de conversación o en su propia interfaz de terminal. Al cambiar de vista, la conversación continúa donde estaba.
- Archivar no es eliminar. Archive el trabajo terminado para mantener ordenado el árbol. Las sesiones archivadas siguen pudiéndose leer en la base de conocimientos y se pueden restaurar o exportar en cualquier momento.
Acerca de las capturas de pantalla
Las capturas de pantalla se tomaron en un entorno de desarrollo con datos de demostración, con la interfaz en inglés (el idioma predeterminado del producto) y el tema oscuro. Algunas son anteriores a cambios recientes de la interfaz, como la pestaña Base de conocimientos del panel derecho, el botón Comentarios o la categoría de ajustes Vista de conversación; cuando una captura no coincide con el texto, el texto describe la versión actual. Las cifras de uso de la cuenta, las rutas y otros datos similares son valores de ejemplo.