Uso de la terminal

Este capítulo trata sobre el terminal en sí: entrada/salida, búsqueda dentro del terminal, copiar/pegar e imágenes, el comando vopen, selección de shell en Windows y grabación de sesiones.

1. Conceptos básicos

Una sesión de terminal es un shell real (el shell predeterminado del sistema en macOS / Linux; cmd por defecto en Windows, con posibilidad de cambiarlo — véase §5). El directorio de trabajo es el raíz del proyecto por defecto y se puede modificar en el formulario de edición de la sesión, el cual también ofrece una opción de “Comando de inicio”: se ejecuta automáticamente cada vez que se inicia la sesión (por ejemplo, pnpm dev).

La latencia al escribir está diseñada específicamente: cuando los agentes saturan la pantalla, la entrada tiene prioridad y las pestañas en segundo plano se ralentizan, de modo que lo que se muestra en primer plano nunca se retrasa con respecto a las teclas pulsadas. Si una interfaz TUI parece tener errores después de cambiar de pestaña, el botón de volver a dibujar en la parte superior del panel fuerza una nueva pintura completa.

2. Búsqueda dentro del terminal (⌘F)

Busca en el historial de desplazamiento del terminal actual, con navegación hacia adelante/atrás:

Para buscar en diferentes sesiones e historial, utiliza la búsqueda global (⌘⇧F) — véase Gestión de interfaz y sesiones §8.

3. Copiar y pegar

• Selecciona el contenido para resaltarlo; el menú contextual ofrece opciones de copiar/pegar, y los comandos habituales ⌘C / ⌘V funcionan normalmente.
• Dentro de los programas TUI que capturan el ratón (vim, htop), mantén presionada Option/Alt mientras arrastras para forzar una selección de texto normal.

El modo “Pegar imagen” es el canal para introducir imágenes en los agentes: pega o arrastra una captura de pantalla/archivo de imagen al terminal, y VelaTerm escribe la imagen en una ubicación temporal y muestra su ruta de archivo en el terminal, exactamente como lo esperan las CLI como claude. Ajustes relacionados: “Pegar imagen” permite elegir entre “Subir como archivo” (siempre se guarda en una ruta concreta) y “Valor predeterminado del agente”; “Limpiar automáticamente imágenes pegadas” elimina periódicamente esas imágenes temporales, con un botón de “Limpiar ahora”.

4. vopen: abrir archivos y páginas desde la terminal

Cada sesión incluye tres comandos pequeños en su PATH (sin instalación necesaria): vopen, vspawn, vspawn-tree. Tenga en cuenta que se trata de comandos de terminal; las habilidades / del mismo nombre que se utilizan dentro de las conversaciones de Claude son algo distinto y requieren activar la opción Vela Skills en Ajustes ▸ General. vopen envía contenido al panel central:

vopen README.md          # markdown → WYSIWYG editor
vopen src/main.rs        # source code → syntax-highlighted editor
vopen diagram.png        # image → built-in image viewer
vopen https://crates.io  # URL → built-in browser tab (desktop only)

Pestañas de documentos completas (edición en modo dual, buscar y reemplazar, exportación PDF): Pestañas de Documento y Navegador. Creación mediante vspawn: Creación de Sesiones y Colaboración Git.

5. Selección de shell (solo Windows)

En Windows, las sesiones de terminal pueden elegir explícitamente un shell — PowerShell / pwsh / cmd / Git Bash — a través del submenú “Nuevo”, del desplegable del formulario de edición de la sesión o haciendo clic con el botón derecho en “Shell ▸”; la sesión en ejecución aplica el cambio al reiniciarse. Ajustes ▸ Terminal ▸ “Shell predeterminado” establece el valor por defecto para nuevas sesiones.

Acerca de la versión incluida de Git Bash: el instalador completo incluye la versión total (git, ssh, perl incluidos); el instalador mínimo incluye solo un subconjunto esencial, y si faltan comandos se solicita la descarga bajo demanda de la versión completa (también disponible haciendo clic con el botón derecho en “Descargar Git Bash completo”). Las sesiones de agente no se ven afectadas; siempre utilizan PowerShell.

macOS / Linux no tienen selector de shell; las sesiones usan el shell predeterminado del sistema ($SHELL).

6. Grabación de sesiones

Ajustes ▸ Avanzado ▸ “Grabar registros de sesión” (desactivado por defecto). Cuando está activado, el contenido de la terminal se graba en un archivo local desde el momento en que comienza la sesión (límite de 50 MB por sesión). Esto ofrece dos ventajas:

• Las sesiones archivadas permiten reproducir la terminal tal como se veía;
• La búsqueda global puede encontrar la salida de la terminal estándar (las conversaciones de agente no necesitan grabación, ya que cuentan con transcripciones).

Los archivos de grabación se eliminan cuando se elimina la sesión.

7. Atajos comunes

macOS valores predeterminados a continuación; en Windows / Linux, reemplace ⌘ por Ctrl+Alt (con algunas excepciones: consulte la página de Ajustes). Todo excepto ⌘1–9 y el trío de tamaños de fuente se puede volver a asignar en Ajustes ▸ Atajos.