Usar terminales, scripts de configuración y scripts de ejecución
Agent Manager mantiene las terminales vinculadas al worktree seleccionado. Los comandos se ejecutan en ese worktree, no en el checkout principal.
Abrir una terminal
| Acción | Atajo |
|---|---|
| Nueva pestaña de terminal en el área principal | Ctrl+Shift+T |
| Nueva pestaña de terminal en el panel lateral, cuando una terminal lateral tiene el foco | Ctrl+T |
| Enfocar u ocultar la terminal | Ctrl+/ |
| Terminal anterior o siguiente | Ctrl+Shift+[ / Ctrl+Shift+] |
En macOS, use Cmd en lugar de Ctrl. También puede ejecutar los comandos Agent Manager correspondientes desde la Command Palette.
El botón de terminal abre una terminal en el Agent Manager panel (Panel de Agent Manager) o una VS Code terminal (Terminal de VS Code). Elíjalo en el menú del botón; cada panel recuerda su elección.
Compruebe el directorio de trabajo de la terminal antes de ejecutar un comando. Un comando destinado a otro worktree puede leer o modificar el checkout equivocado.
Preparar worktrees nuevos con un script de configuración
Un script de configuración se ejecuta antes de que el agente empiece en un worktree nuevo. Úselo para preparar el proyecto localmente, por ejemplo instalando dependencias o generando archivos.
Agent Manager busca el script en .aicockpit/, en la raíz del repositorio:
setup-scriptosetup-script.shen Linux y macOS;setup-script.ps1,setup-script.cmdosetup-script.baten Windows.
Para crearlo o editarlo, abra la configuración del proyecto en Agent Manager y use Worktree Setup Script (Script de configuración de Worktree). Mantenga el script seguro para ejecutarse más de una vez y nunca incluya credenciales en él.
El script se ejecuta dentro del worktree de destino mientras este aparece como Setting up worktree (Configurando worktree). Seleccione Stop setup script (Detener el script de configuración) para interrumpirlo. Si falla, la terminal muestra el código de salida: corrija el script para los próximos worktrees y ejecute los pasos que faltaron en la terminal del worktree.
Iniciar el proyecto con un script de ejecución
Un script de ejecución inicia el proyecto, por ejemplo un servidor de desarrollo. Se ejecuta en el worktree seleccionado o, en el checkout local, en la raíz del repositorio.
- Seleccione Configure run script (Configurar script de ejecución) para crear
.aicockpit/run-script(o la variante.ps1,.cmdo.baten Windows) a partir de una plantilla. - Reemplace los ejemplos comentados por el comando que inicia su proyecto.
- Presione Ctrl+E (Cmd+E en macOS) o seleccione Run script (Ejecutar script) para iniciarlo.
El script de ejecución usa el mismo destino de terminal que el botón de terminal.