Ir al contenido

La app de terminal

remotxai tui abre en tu terminal las sesiones del ordenador en el que estás. Ocupa toda la ventana: la lista de sesiones y, al abrir una, su transcripción arriba, las tarjetas que esperan una respuesta encima del cuadro de mensaje y una línea de estado abajo. El comando se describe aquí.

La pantalla completa es la vista por defecto. Vuelve a la vista en línea cuando la salida no es una terminal, cuando TERM es dumb o está vacío, cuando la ventana mide menos de 40 columnas por 12 filas, en iTerm2 bajo tmux -CC y cuando la pantalla completa no arranca (la terminal queda como estaba y una línea lo dice). Pon REMX_TUI=inline para usar siempre la vista en línea. Un lector de pantalla funciona mejor con la vista en línea.

Tecla Qué hace
Arriba, abajo, intro Elegir una sesión de la lista y abrirla.
tab o ctrl+k Ir entre la lista y la sesión abierta.
esc Interrumpir un turno en marcha. Sin nada en marcha, volver a la lista.
ctrl+c dos veces, ctrl+d Salir.
shift+tab Bajar el modo de la sesión.
Re Pág, Av Pág, ctrl+p Desplazar la transcripción media pantalla. ctrl+p sube una página. La rueda del ratón también desplaza.
Arriba, abajo Desplazar una fila cuando el compositor no tiene texto por el que moverse ni un prompt que recuperar.
inicio, fin, ctrl+u Con el compositor vacío, ir a la primera fila, ir a la última o subir una página.
ctrl+inicio Ir a la primera fila.
ctrl+fin Ir a la última fila y volver a seguir la salida nueva.
ctrl+f Copiar la última respuesta. Si tiene código, 1 a 9 copia ese bloque y ctrl+f otra vez copia la respuesta entera.
ctrl+y Dar el ratón a la terminal, o recuperarlo.
ctrl+o Revisar la transcripción. Mira más abajo.
1, 2, p Permitir una vez, denegar, o abrir la ventana de presencia en una tarjeta.
ctrl+b Abrir la lista de subagentes de la sesión. intro abre la transcripción de uno, esc vuelve.
? Mostrar todas las teclas. En la lista, o como primer carácter de un mensaje vacío.

Las teclas que responden tarjetas, las de la ventana de presencia (ctrl+w, ctrl+g, ctrl+t, ctrl+l, ctrl+x) y los menús / y @ del cuadro de mensaje funcionan igual que en la vista en línea. Pegar una ruta o soltar un archivo lo adjunta.

La fila de abajo guarda el estado a la izquierda y como mucho tres atajos a la derecha. El estado es el ordenador, el dispositivo, el modo de la sesión, la cola, cuánta ventana de contexto se usa (una barra pequeña que pasa a amarillo desde el 70 por ciento y a rojo desde el 90) y, mientras la sesión tiene subagentes, una etiqueta como 2/5 subagentes (en marcha sobre el total). Un aviso de presencia aparece ahí mientras hay uno abierto. ? lista todas las teclas. En una terminal estrecha caen partes enteras, las menos importantes primero, y la fila nunca se parte en dos líneas.

La etiqueta y ctrl+b abren una lista de los subagentes de la sesión con el nombre, el estado y la última actividad de cada uno. intro o un clic en una fila abre su transcripción, con el prompt que recibió. La lista y las transcripciones son de solo lectura: ninguna tecla ni clic ahí interrumpe ni detiene un subagente. La cabecera de la sesión muestra la misma cuenta junto al modo.

La app toma el ratón mientras se ejecuta.

  • La rueda desplaza la transcripción, tres filas por giro por defecto. Cuando la vista llega al mensaje cargado más antiguo, la página anterior se carga sola y la vista mantiene su sitio.
  • Un clic en una sesión de la lista la abre. Un clic en el cuadro de mensaje pone el cursor ahí.
  • Un clic en la primera fila de una llamada a una herramienta abre o cierra sus argumentos. Una llamada cuya entrada el ordenador no envió nunca se abre.
  • Un clic en un mensaje tuyo elige su turno. Un segundo clic lo suelta.
  • Cuando has subido, una píldora abajo cuenta las filas que llegaron por debajo. Haz clic en ella, o pulsa ctrl+fin, para volver. El mensaje del turno que ya pasó queda atenuado en la fila de arriba, y un clic en él va a ese turno.
  • Las tarjetas tienen botones: Permitir una vez, Denegar, Abrir la ventana y los de las preguntas. Un botón pulsa la misma tecla, tras la misma breve espera, y un clic que empieza en un botón y acaba en otro no hace nada.

REMX_TUI_MOUSE=wheel da a la app solo la rueda, y off no le da nada, así que la terminal selecciona y desplaza como siempre.

Arrastra para seleccionar. Doble clic elige una palabra, y una ruta o una URL cuenta como una sola palabra. Triple clic elige una línea. La selección se ve en vídeo inverso y se copia al soltar.

Lo que llega al portapapeles es lo que escribió el agente. Las filas partidas por el ancho se copian como una sola línea, una cita se copia sin su barra, el código sin su margen, una tabla por celdas, y el relleno tras una fila nunca se copia.

La copia va a la herramienta de portapapeles del ordenador. Por SSH, o cuando ninguna herramienta la toma, la terminal recibe una escritura OSC 52, cortada a 100 000 bytes con un aviso. La línea de estado dice copiado cuando termina.

Tu terminal puede seguir seleccionando por su cuenta mientras la app tiene el ratón. Mantén la tecla de escape al arrastrar: Opción en iTerm2, Fn en Terminal.app y Mayús en el resto. El primer arrastre la nombra. ctrl+y libera el ratón todo el tiempo que quieras.

Un enlace de markdown, un autoenlace, una dirección web y una ruta de archivo absoluta en el texto del agente son enlaces. Solo cuentan las direcciones http, https, file y mailto, y solo cuando están limpias.

  • Ctrl+clic abre un enlace web en tu navegador. En Ghostty y Warp basta un clic normal. iTerm2, kitty y Terminal.app conservan su propio Cmd+clic.
  • Un enlace a un archivo se muestra en tu gestor de archivos y nunca se abre, así que un clic no puede ejecutarlo.
  • Por SSH, sin pantalla, y para mailto, el clic copia el enlace.
  • El mismo enlace se abre como mucho una vez por segundo.

Un clic derecho abre un menú para lo que hay debajo.

Sobre Opciones
Una selección Copiar, Copiar como markdown.
Un enlace Abrir enlace, Copiar enlace.
Una llamada a una herramienta que puede abrirse Abrir o Cerrar, Copiar entrada, Copiar salida.
Cualquier otra fila de un turno Copiar mensaje, Copiar turno, Copiar turno como markdown, Ir al mensaje.

Arriba y abajo mueven, intro elige, esc o cualquier otra tecla lo cierra, y un clic fuera lo cierra sin hacer nada más. Con un menú abierto, el cuadro de mensaje y las tarjetas no reciben teclas. Ninguna opción responde una aprobación ni una pregunta.

ctrl+o convierte la transcripción en una vista de solo lectura con una barra en la fila de abajo. El cuadro de mensaje y las tarjetas se apartan hasta que salgas, así que ninguna tecla que pulses ahí puede enviar un mensaje ni responder una tarjeta. En la vista en línea, ctrl+o abre las vistas en vivo de subagentes y procesos en segundo plano.

  • / empieza una búsqueda. Escribe las palabras y, según escribes, la vista salta a la primera coincidencia desde la parte de arriba de la pantalla. La búsqueda ignora mayúsculas y busca dentro de una misma fila impresa.
  • intro conserva la búsqueda. esc mientras escribes sale del modo de revisión.
  • n va a la siguiente coincidencia y N a la anterior, dando la vuelta en los extremos. La coincidencia se ve en vídeo inverso y la vista se desplaza hasta ella. La barra las cuenta, como en 3 de 12.
  • Arriba, abajo, Re Pág y Av Pág desplazan.
  • [ imprime toda la transcripción en el historial propio de la terminal: la app deja la pantalla completa, imprime cada turno con sus llamadas a herramientas abiertas y espera. Desplázate, busca y selecciona con las herramientas de tu terminal. esc, ctrl+o o ctrl+c vuelve a la app.
  • esc o ctrl+o sale del modo de revisión.

La búsqueda cubre la transcripción tal como estaba al pulsar /. Lo que llegue mientras tanto se busca la próxima vez.

Son variables de entorno que pones en tu shell, en el ordenador donde ejecutas la app.

Variable Valores Qué hace
REMX_TUI fullscreen, inline, auto Qué vista usar. auto y sin definir significan pantalla completa cuando la terminal puede con ella.
REMX_TUI_MOUSE on, wheel, off Qué toma la app del ratón. Por defecto on.
REMX_TUI_FULL_REPAINT 1 Envía todas las celdas de cada fotograma. Pruébalo cuando una terminal deja restos, como puede pasar en Windows Terminal.
REMX_TUI_SCROLL_SPEED 1 a 20 Filas por giro de rueda. Por defecto 3.
REMX_TUI_REDUCED_MOTION 1 Pide un indicador quieto y un desplazamiento sin suavizado. La pantalla completa aún no tiene ninguno de los dos, así que hoy no cambia nada.

Un valor que la app no conoce es el valor por defecto.

tmux necesita set -g mouse on, o la rueda desplaza tmux y no la app. Los hipervínculos necesitan tmux 3.4 o posterior con hipervínculos activados en terminal-features, y una copia OSC 52 necesita set-clipboard on. Por SSH la app nunca inicia un programa en el ordenador por un clic, así que un clic en un enlace o en una ruta de archivo la copia.