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.

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. Ao lado desses arquivos, o Maestri grava um sidecar portátil role.json que descreve a responsabilidade — nome, cor do badge e prompt — para que a responsabilidade viaje com o diretório entre workspaces e entre máquinas.

Descobrindo responsabilidades no seu repositório

Quando você abre a tela Editar de um terminal local, o botão Descobrir Responsabilidades varre o diretório de trabalho atrás de arquivos role.json e permite importá-los. Você vê uma prévia de cada responsabilidade descoberta e pode selecionar várias para adicionar à sua biblioteca — útil quando você dá checkout numa branch de um colega que traz sua própria pasta .maestri.

Clique direito para excluir

Os cards de responsabilidade na tela Editar suportam clique direito → Excluir Responsabilidade com confirmação, então você pode limpar sua biblioteca sem sair da tela.

Lendo e editando responsabilidades pela CLI

Agentes conectados — e você, em qualquer shell — podem ler e editar responsabilidades pela CLI maestri:

• maestri role show "Nome" — imprime o prompt da responsabilidade
• maestri role write "Nome" "novo prompt" — substitui o prompt inteiro
• maestri role edit "Nome" "texto antigo" "texto novo" — substitui uma substring dentro do prompt

O padrão é o mesmo do maestri note edit, então um agente consegue refinar sua própria responsabilidade entre execuções sem sair do terminal.

Temas de terminal

O Maestri vem com quatro cards de tema em Configurações → Terminal → Aparência: Sistema, Escuro, Claro e Personalizado.

O card Personalizado abre um seletor em tela cheia com mais de 30 esquemas de cores embutidos derivados do projeto iTerm2 Color Schemes — Dracula, Catppuccin, Tokyo Night, Gruvbox, Nord, One Dark, Solarized, Rosé Pine, Everforest e outros. Cada esquema carrega dados de cor completos, incluindo cor do texto do cursor, fundo e texto da seleção, e os terminais SSH também respeitam isso.

Seguir aparência do sistema

No seletor, ative Seguir aparência do sistema e paire um tema claro com um tema escuro. O Maestri alterna entre eles automaticamente quando o macOS troca entre modo claro e escuro.

Use seus próprios temas

Coloque qualquer arquivo de tema no formato Ghostty em ~/.maestri/terminal/themes/ e ele aparece no seletor em Da sua pasta, junto com os embutidos. Sem precisar reiniciar.

Quando um agente precisa de você

Quando um terminal para de produzir saída — geralmente porque o agente está esperando uma decisão ou terminou seu turno — o Maestri marca o terminal com um ponto vermelho de atenção no cabeçalho. Use ⇧A no canvas para pular para o próximo, percorrendo todos os andares.

Para os momentos em que você não está olhando para o canvas, ative Notificar quando um agente precisa de atenção em Configurações → Notificações. O Maestri passa a postar uma notificação do sistema sempre que um terminal acende esse ponto — mesmo quando o Maestri está em primeiro plano. Clicar na notificação foca o terminal correspondente, trocando de workspace e andar automaticamente se necessário.

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.