Documentação

Agentes e perfis

Perfis, worktrees, modos de permissão, contas do Claude e retomada.

Perfis de agente

Um perfil descreve um agente reutilizável: provedor, modelo, pontos fortes, custo relativo, ferramentas liberadas e regras. Crie e edite perfis pelos comandos Novo perfil de agente e Editar perfil. O Maestro usa os pontos fortes e o custo de cada perfil para decidir quem faz o quê.

A IDE já traz perfis prontos para Claude Code (Haiku, Sonnet e Opus), Codex e Gemini CLI. Um perfil com comando próprio roda qualquer agente compatível com ACP, e um perfil do adaptador local usa Ollama ou LM Studio.

Conversar com um agente

Abra o chat com Abrir chat dos agentes ou crie um com Novo agente. Em cada sessão você pode:

  • pausar, retomar e parar o agente;
  • abrir o log e um terminal na pasta do agente;
  • trocar modelo, raciocínio e outras opções que o agente oferecer;
  • ver os arquivos alterados e aplicar ou descartar cada um.

As sessões ficam salvas. Se a IDE fechar no meio do trabalho, a conversa volta inteira, e uma mensagem nova retoma o agente no mesmo worktree.

Modos de permissão

Modo O que o agente pode fazer sozinho
perguntar Nada: cada ação espera a sua aprovação
aprovar-leitura Ler e buscar; editar e rodar comandos ainda perguntam
aprovar-tudo Tudo, dentro do worktree
autopilot Tudo, e as decisões da execução são respondidas pela opção segura

No autopilot, o trabalho fica no branch do agente e chega ao main por PR. Comandos SSH, ações na Hostinger e envio de segredos sempre esperam você, em qualquer modo. O modo pode mudar com o agente rodando, pelo chat, pelo celular ou por fakl modo <sessão> <modo>.

Contas do Claude em paralelo

A IDE guarda até três contas do Claude, cada uma na sua pasta, sem misturar com o seu ~/.claude. Entre em cada uma com Entrar numa conta do Claude e troque a conta ativa com Claude: Trocar conta. Os agentes abertos trocam junto, sem perder a conversa. A barra de status mostra o uso das janelas de 5 horas e da semanal.

Quando o provedor bate o limite

Se um agente bate o limite de sessão do provedor, a tarefa fica pausada em vez de falhar. Você pode retomar na hora, trocar de conta ou ligar a retomada automática, que espera o horário informado pelo provedor. O tempo de espera não conta no tempo da tarefa.

Esta documentação acompanha a versão em desenvolvimento e pode mudar.