# Terminais e Agentes

Os terminais são onde você e seus agentes fazem as coisas acontecerem. Cada terminal é um shell interativo completo — e com agentes de código rodando dentro deles, eles se tornam o principal lugar onde o trabalho de fato acontece.

## Criando um terminal

1. Selecione a ferramenta **Terminal** na barra de ferramentas superior.
2. Clique e arraste no canvas para desenhar o terminal no tamanho desejado.
3. Um modal aparece — selecione um agente de código na lista de predefinições.

**Nota**  
O Maestri espera que seus agentes já estejam instalados. Para instruções de instalação do Claude Code, Codex ou outros agentes suportados, consulte a documentação de cada um.

Você também pode dar a cada terminal um **nome** e **ícone** para facilitar a identificação, especialmente quando você tiver muitos no canvas.

## Responsabilidades

Responsabilidades permitem definir um conjunto de instruções para uma instância específica de terminal. Quando uma responsabilidade é atribuída, o Maestri injeta automaticamente essas instruções quando o agente inicia — então você não precisa se repetir toda sessão.

**Exemplos de responsabilidades:**

- _Líder_ — Define o agente como coordenador que delega para os outros
- _Desenvolvedor_ — Foca o agente puramente na implementação
- _Revisor_ — Instrui o agente a revisar e criticar o código
- _Testador_ — Foca o agente em escrever e executar testes

### Gerenciando responsabilidades

Vá em **Configurações → Agentes** para criar, editar e organizar responsabilidades. Cada responsabilidade tem um nome, um badge colorido e um conjunto de instruções. Atribua uma responsabilidade ao criar um terminal ou depois via clique com o botão direito.

As responsabilidades funcionam iniciando o agente em um subdiretório do projeto com seu próprio `CLAUDE.md` / `AGENTS.md`, de forma que cada agente pode ter instruções únicas. O Maestri gerencia esses arquivos automaticamente na medida que você atribui e retira responsabilidades.

**Nota**  
Considere adicionar o diretório `.maestri` ao `.gitignore` caso você trabalhe com mais pessoas no mesmo repositório, já que responsabilidades não são compartilháveis no momento.

**Dica**  
O comando `maestri list` (disponível para agentes conectados) mostra a responsabilidade atribuída de cada agente, para que os agentes saibam com quem estão falando.

## Navegando entre terminais

Quando seu canvas tem muitos terminais, a navegação pelo teclado é essencial.

Segure `` — um badge numerado aparece no cabeçalho de cada terminal. Enquanto segura ``, pressione o número para focar imediatamente naquele terminal.

Domine esse atalho e você consegue alternar entre 9 agentes quase simultaneamente sem tocar no mouse.

## Removendo um terminal

Para remover um terminal do canvas, selecione-o e pressione `⌘W`. Isso fecha o terminal e o remove do canvas.