Usar terminais, scripts de configuração e scripts de execução
O Agent Manager mantém os terminais ligados ao worktree selecionado. Os comandos rodam nesse worktree, não no checkout principal.
Abrir um terminal
| Ação | Atalho |
|---|---|
| Nova aba de terminal na área principal | Ctrl+Shift+T |
| Nova aba de terminal no painel lateral, quando um terminal lateral está em foco | Ctrl+T |
| Focar ou ocultar o terminal | Ctrl+/ |
| Terminal anterior ou seguinte | Ctrl+Shift+[ / Ctrl+Shift+] |
No macOS, use Cmd no lugar de Ctrl. Você também pode executar os comandos Agent Manager correspondentes pela Command Palette.
O botão de terminal abre um terminal no Agent Manager panel (Painel do Agent Manager) ou um VS Code terminal (Terminal do VS Code). Escolha no menu do botão; cada painel lembra a sua escolha.
Confira o diretório de trabalho do terminal antes de executar um comando. Um comando destinado a outro worktree pode ler ou alterar o checkout errado.
Preparar novos worktrees com um script de configuração
Um script de configuração roda antes de o agente começar em um novo worktree. Use-o para preparar o projeto localmente, por exemplo instalando dependências ou gerando arquivos.
O Agent Manager procura o script em .aicockpit/, na raiz do repositório:
setup-scriptousetup-script.shno Linux e no macOS;setup-script.ps1,setup-script.cmdousetup-script.batno Windows.
Para criá-lo ou editá-lo, abra as configurações do projeto no Agent Manager e use Worktree Setup Script (Script de configuração do Worktree). Mantenha o script seguro para rodar mais de uma vez e nunca coloque credenciais nele.
O script roda dentro do worktree de destino enquanto ele aparece como Setting up worktree (Configurando worktree). Selecione Stop setup script (Parar o script de configuração) para interrompê-lo. Se falhar, o terminal mostra o código de saída: corrija o script para os próximos worktrees e execute as etapas que faltaram no terminal do worktree.
Iniciar o projeto com um script de execução
Um script de execução inicia o projeto, por exemplo um servidor de desenvolvimento. Ele roda no worktree selecionado ou, no checkout local, na raiz do repositório.
- Selecione Configure run script (Configurar script de execução) para criar
.aicockpit/run-script(ou a variante.ps1,.cmdou.batno Windows) a partir de um modelo. - Substitua os exemplos comentados pelo comando que inicia o seu projeto.
- Pressione Ctrl+E (Cmd+E no macOS) ou selecione Run script (Executar script) para iniciá-lo.
O script de execução usa o mesmo destino de terminal do botão de terminal.