Ir al contenido

Crear y navegar entre sesiones

Cómo abrir una terminal o un agente en la pantalla Terminal, alternar entre las pestañas abiertas y descubrir qué está ejecutándose.

Ver Markdown

Abrir un shell

  1. Abre la pantalla Terminal del proyecto.
  2. En la barra de pestañas, usa el botón de pestaña nueva.
  3. En Windows, el mismo menú ofrece el shell: PowerShell, CMD Prompt, Git Bash o WSL. En macOS y Linux, la pestaña nueva usa el shell predeterminado de la máquina.

La sesión nace en el directorio de trabajo del proyecto y pasa a ser una pestaña de la pantalla Terminal.

Abrir un agente

Una CLI de agente es una sesión como cualquier otra: se ejecuta en el panel, con historial, búsqueda y restauración idénticos a los de un shell.

Si ya sabes qué agente quieres, crear la sesión ya con el agente es mejor que abrir un shell y escribir el comando: la sesión nace con el proceso correcto, sin una ventana en la que un shell tiene el control.

Qué esperar: el agente todavía está subiendo cuando la creación termina. Escribirle en ese instante llega mezclado — el texto cae en el shell antes de que la interfaz del agente tome el control. Espera a que el agente quede ocioso antes de enviar el primer mensaje; el paso a paso está en Trabajar con un agente en la Terminal.

Alternar entre pestañas

  • Haz clic en la pestaña para activarla.
  • Cuando hay pestañas fuera del área visible, la barra de pestañas se desplaza: usa las flechas de los extremos para alcanzarlas.
  • Cambiar de pestaña no interrumpe lo que está ejecutándose en las demás.

Descubrir qué está abierto

Además de la propia barra de pestañas, existe la lista de sesiones, útil cuando hay muchas pestañas, cuando quieres el identificador de una sesión o cuando la sesión está en otro workspace.

Lo que la lista devuelve:

  • una entrada por sesión viva, con título, identificador y el workspace al que pertenece;
  • totalCount — cuántas sesiones existen de hecho;
  • truncated — si la lista que recibiste está cortada, por paginación o por el techo interno del servidor.

Lee truncated antes de concluir que la lista está completa. La lista tiene un techo interno de seguridad; paginar solo cambia lo que se muestra, no el techo.

Las sesiones creadas a partir de una tarjeta del Canvas pueden tardar unos segundos en aparecer en la lista.

Detalles y cambio de foco

  • Inspeccionar una sesión devuelve metadatos y una vista previa de lo que está en pantalla, sin terminar ni escribir nada en el proceso.
  • Cambiar a una sesión cambia la pestaña visible — el mismo efecto que hacer clic en la pestaña. No cambia lo que está ejecutándose.

Por línea de comandos

Para crear, listar, inspeccionar y cambiar de pestaña sin salir de la terminal, consulta Referencia de comandos de la Terminal — los comandos de creación, listado, detalle y cambio, con las opciones de selección de workspace y paginación.

Si algo no funciona

  • La sesión no aparece en la lista: revisa el workspace de la consulta y el campo truncated; las sesiones de tarjeta del Canvas tardan unos segundos.
  • El agente recibió texto mezclado: escribiste antes de que su interfaz tomara el control. Usa Leer, enviar y esperar para esperar la condición correcta antes de escribir.
  • El panel no abre: sigue Cuando la terminal no abre.