Uso del terminal

Este capítulo trata del propio terminal: entrada y salida, búsqueda en el terminal, copiar y pegar, pegado de imágenes, sugerencias de comandos, los comandos v integrados, los comandos en segundo plano iniciados con vrun, la selección de shell en Windows, la grabación de sesiones, los ajustes de renderizado y los atajos.

1. Conceptos básicos

Una sesión de terminal ejecuta una shell real. En macOS y Linux es la shell predeterminada del sistema ($SHELL); en Windows es cmd de forma predeterminada y se puede cambiar (consulte el §7). El directorio de trabajo es, de forma predeterminada, la raíz del proyecto. El formulario de edición de la sesión permite cambiar el «Directorio de trabajo (vacío = raíz del proyecto)» y definir un «Comando de inicio (opcional)», que se ejecuta cada vez que se inicia la sesión (por ejemplo, pnpm dev).

Cuando varios agentes generan mucha salida a la vez, VelaTerm da prioridad a lo que usted escribe y a la pestaña visible, y limita la salida de las pestañas en segundo plano. Este comportamiento se controla en Ajustes ▸ Avanzado ▸ «Salida con prioridad en primer plano» (activado de forma predeterminada). Si alguna vez un programa a pantalla completa se ve desordenado después de cambiar de pestaña, haga clic en el botón «Redibujar» del encabezado del panel para volver a dibujarlo. Ajustes ▸ Avanzado ▸ «Redibujar al cambiar de pestaña» lo hace automáticamente cada vez que una pestaña se vuelve visible.

2. Búsqueda en el terminal (⌘F)

⌘F abre una barra de búsqueda («Buscar en el terminal») para el historial de desplazamiento del terminal actual, con botones para ir a la coincidencia anterior y a la siguiente:

Para buscar en varias sesiones y en el historial, use la búsqueda global (⌘⇧F), descrita en Gestión de la interfaz y sesiones.

3. Copiar y pegar

• Seleccione texto con el ratón y, a continuación, use ⌘C / ⌘V o el menú contextual («Copiar», «Pegar», «Seleccionar todo», «Limpiar», «Buscar…»).
• En los programas que capturan el ratón (vim, htop y la mayoría de las interfaces de agente), mantenga pulsada la tecla Option en macOS, o Shift en Windows y Linux, mientras arrastra para forzar una selección de texto normal.
• Las interfaces de agente, como Claude Code y Codex, pueden copiar texto por sí mismas. Cuando acaban de hacerlo y no hay nada seleccionado en el terminal, el menú contextual muestra «N caracteres copiados · ⌘V para pegar».

4. Pegar imágenes

Para proporcionar una imagen a un agente de línea de comandos, péguela o arrástrela al terminal. Ajustes ▸ Terminal ▸ «Pegar imagen» ofrece dos opciones:

• Pegar ruta de archivo (predeterminado): la imagen se guarda como archivo temporal y su ruta se inserta en la línea de comandos, de modo que cualquier agente capaz de leer archivos puede abrirla. Codex la recibe como image_path: ….
• Pegado nativo: Claude Code o Codex leen la imagen del portapapeles del sistema y muestran su propio marcador de imagen. Esta opción solo está disponible en la aplicación de escritorio local; las sesiones remotas siempre pegan una ruta de archivo para que el agente pueda leer la imagen en su propia máquina.

Ajustes ▸ Comportamiento ▸ «Limpiar imágenes pegadas automáticamente» elimina estos archivos temporales al salir de la aplicación y, al iniciarla, borra los restos de más de 24 horas. «Limpiar ahora» los elimina de inmediato. Las imágenes insertadas en documentos nunca se ven afectadas.

5. Sugerencias de comandos

En las sesiones de terminal normales de macOS y Linux, VelaTerm puede mostrar una lista de sugerencias creada a partir de las definiciones de autocompletado de su propia shell. Ajustes ▸ Terminal ▸ «Sugerencias de comandos» permite elegir «Automáticas» (predeterminado), «Con Tab» o «Desactivadas». Use las teclas de flecha para seleccionar una opción y Tab para insertarla; Enter siempre ejecuta el comando tal como se ha escrito. Cuando la selección no puede avanzar más, ↑ y ↓ vuelven a la shell, de modo que ↑ en la primera opción recupera el comando anterior. La lista no está disponible en Windows. Encontrará todos los detalles en Sugerencias de comandos.

6. Comandos integrados

Todas las sesiones que inicia VelaTerm tienen un conjunto de comandos breves en su PATH. No requieren instalación y funcionan tanto en terminales normales como en sesiones de agente:

Ejecute un comando con --help para ver sus opciones; Comandos de sesión describe cada uno en detalle. La mayoría de estos comandos existen también como habilidades en Claude Code (/vopen) y Codex ($vopen); vrun y vflow no tienen habilidad, y vask solo existe como habilidad. Las habilidades se instalan con el botón «Vela Skills» de Ajustes ▸ General.

vopen elige la vista según el tipo de archivo:

vopen README.md          # Markdown → Markdown editor
vopen src/main.rs        # source code → code editor with syntax highlighting
vopen diagram.png        # image → image viewer
vopen https://crates.io  # web address → browser tab (desktop app only)

Las rutas relativas se resuelven respecto al directorio actual, y se pueden abrir varios archivos a la vez. Las pestañas de documento se describen en Pestañas de documentos y navegador; vspawn se describe en Creación de sesiones y colaboración en Git; vkb se describe en Grafo de código y base de conocimientos y en Bases de conocimientos locales.

6.1 Comandos en segundo plano (vrun)

vrun <label> <command...> inicia un comando, espera a que termine y, después, imprime el código de salida, el tiempo transcurrido y el final de su registro. Así, un agente que inicia una compilación o unas pruebas largas con vrun conoce el resultado en cuanto está disponible. Cerrar la sesión no detiene el comando. vrun --status <label> informa sobre un comando iniciado anteriormente, y -t <seconds> establece cuánto tiempo se espera (1800 segundos de forma predeterminada); si se agota la espera, vrun termina con el código 124 y deja el comando en ejecución.

Mientras se ejecutan estos comandos, aparece una fila «Comandos en segundo plano» encima del terminal. Cada entrada muestra su etiqueta y «En ejecución (…)», un botón «Registro» que abre la salida del comando y un botón «Detener»; haga clic en «Confirmar detención» para terminar el comando. La fila desaparece cuando no hay nada en ejecución.

7. Selección de shell (solo Windows)

En Windows, las sesiones de terminal pueden usar cualquier shell detectada: PowerShell, pwsh, cmd, Git Bash y todas las distribuciones de WSL instaladas. Elíjala en el submenú «Nuevo terminal», en el campo «Shell (vacío = predeterminado del sistema)» del formulario de edición de la sesión o en el menú «Shell» del clic derecho. Una sesión en ejecución se reinicia de inmediato con la nueva shell. Ajustes ▸ Terminal ▸ «Shell predeterminada» define la shell de los terminales nuevos que no tienen una elección explícita.

Las entradas de WSL aparecen como WSL: <distribution> solo cuando WSL informa de una distribución instalada. Al elegir una, se inicia esa distribución y el directorio de proyecto de Windows de la sesión se asigna dentro de ella. WSL solo está disponible para las sesiones de terminal normales; las sesiones de agente siguen usando la shell del sistema Windows anfitrión. Los comandos v integrados no están disponibles en los terminales WSL.

Acerca del Git Bash incluido: el instalador full incluye el Git Bash completo (con git, ssh y perl). El instalador min incluye un subconjunto básico; cuando ejecuta un comando que falta, ofrece descargar la versión completa, que también está disponible en la opción «Descargar Git Bash completo» del menú del clic derecho. Las sesiones de agente no se ven afectadas, ya que usan PowerShell.

macOS y Linux no tienen selector de shell; las sesiones usan la shell predeterminada del sistema.

8. Grabación de sesiones

Ajustes ▸ Avanzado ▸ «Registrar registros de sesión» está desactivado de forma predeterminada. Cuando está activado, VelaTerm guarda en un archivo de registro local la salida de terminal de las sesiones de agente que se ejecutan en la vista de terminal, hasta 50 MB por sesión. Las sesiones de terminal normales nunca se graban.

Una grabación permite reproducir una sesión archivada tal como apareció en pantalla y hace que su texto en pantalla se pueda buscar. VelaTerm solo usa una grabación cuando no se puede leer el registro de conversación propio del agente; en caso contrario, se usa el registro de conversación para la visualización y la búsqueda. Los archivos de grabación se eliminan junto con su sesión.

9. Renderizador

Ajustes ▸ Avanzado ▸ «Renderizador del terminal» ofrece DOM (predeterminado) y WebGL. DOM es la opción recomendada en la aplicación de escritorio. Las versiones anteriores ofrecían también un renderizador Canvas; esa opción ya no existe, y si había guardada una preferencia por Canvas, ahora se usa DOM.

10. Atajos habituales

La tabla muestra los valores predeterminados de la aplicación de escritorio para macOS. Las aplicaciones para Windows y Linux usan Ctrl+Alt en lugar de ⌘ para la mayoría de las acciones (dividir hacia abajo es Ctrl+Alt+E, buscar en todas las sesiones es Ctrl+Alt+G y guardar sigue siendo Ctrl+S). Los clientes de navegador usan combinaciones basadas en Ctrl que evitan los atajos propios del navegador. Ajustes ▸ Atajos muestra las combinaciones exactas de su sistema, y allí se pueden modificar todas las acciones, salvo el cambio de pestaña y el tamaño de fuente.