Sessões de agentes
As sessões de agentes são opcionais nesta versão. Ative-as em Configurações → Experimental → Sessões de agentes.
O LaraEnv pode executar as CLIs instaladas do Claude Code, Codex, Kimi e OpenCode dentro do Workspace do Terminal. As sessões são organizadas como projeto → working copy → sessão, enquanto seus terminais permanecem abertos como abas normais.
Iniciar uma sessão
Abra Terminal, expanda o navegador de Agentes e selecione Novo. Procure um projeto, escolha um provedor instalado e depois escolha onde ele deve executar.
Você também pode usar o Command Center: digite um projeto e um provedor, como cotesaude claude, cotesaude codex ou acme kimi. Essa ação rápida inicia no checkout atual; use o launcher completo quando quiser uma branch ou um worktree.
O LaraEnv detecta os provedores pelos executáveis locais de linha de comando e exibe a versão instalada. Ele não instala, autentica nem ignora os controles de segurança dessas ferramentas.
Escolher a working copy
A escolha é explícita em cada início:
- Checkout atual — o padrão. Executa na pasta do projeto como ela está e não altera Git nem roteamento.
- Trocar o checkout principal — muda a pasta existente do projeto para uma branch que você selecionar. O LaraEnv recusa trocas inseguras quando o checkout está sujo ou compartilhado por outro agente ativo.
- Worktree isolado — cria ou reutiliza um checkout separado no diretório de worktrees gerenciado pelo LaraEnv. Isso é opcional, não um requisito para usar agentes.
Vários agentes no checkout atual compartilham os mesmos arquivos. O LaraEnv avisa quando outra sessão ativa já usa esse checkout, mas você decide se quer continuar.
Domínios e worktrees
Criar um worktree não altera automaticamente o Nginx, o arquivo hosts do Windows nem a URL principal do projeto. Se um worktree precisar servir a aplicação, escolha separadamente uma destas opções:
- Manter o domínio canônico do projeto no checkout principal.
- Atribuir explicitamente o domínio canônico ao worktree.
- Criar um hostname de preview separado e editável para o worktree.
Em aplicações Node/Vite com proxy, o preview do worktree também precisa de uma porta própria para evitar conflito entre os servidores principal e isolado. O LaraEnv valida as mudanças de rota e pode restaurar o domínio canônico para o checkout principal.
Gerenciar sessões
O navegador recolhível separa as sessões em Ativas, Recentes e Arquivadas e oferece busca por texto. Em uma sessão, você pode focar a aba, renomear, parar, arquivar seus metadados no LaraEnv e retomá-la quando o provedor tiver um identificador de conversa verificado.
Recolher o navegador não encerra nenhum terminal. Os metadados das sessões ficam separados do histórico de conversas pertencente ao provedor.
Mapa de agentes
Com Sessões de agentes ativadas, a barra inferior inclui um contador de atividade do terminal de agente selecionado e compatível enquanto sua observação está ativa. Abra-o para ver o Mapa de agentes, ou escolha Ver mapa no menu de uma sessão. O contador desaparece quando não há um terminal compatível selecionado ou a observação termina; os mapas de sessões retidas continuam disponíveis nos menus. Abrir o mapa não inicia outro agente nem troca seu terminal.
O mapa mostra o agente principal e os descendentes observados em versões compatíveis do Claude Code e Codex. Selecione um agente para conferir estado, horário da observação e, quando disponíveis, modelo ou informações de tempo. Abrir terminal volta ao terminal da sessão principal. As tarefas em segundo plano aparecem separadamente quando o provedor oferece um inventário compatível; elas não entram na contagem de agentes.
As janelas principal e destacadas do LaraEnv compartilham as observações do backend, mas mantêm suas próprias seleções. O mapa permanece na sessão que você abriu até ser fechado, mesmo que o terminal ativo mude.
O mapa informa o que o provedor local consegue confirmar. Observações desconhecidas, parciais, indisponíveis e desatualizadas são identificadas; a ausência de um evento ou processo não comprova conclusão bem-sucedida. Uma resposta concluída descreve aquele turno observado, não o encerramento permanente do agente. A contagem de agentes trabalhando na barra inferior inclui estados ativos confirmados, enquanto agentes retidos podem continuar no total após encerrar sua atividade.
A atividade fica em memória durante a execução do aplicativo, com retenção limitada. Reiniciar o LaraEnv não restaura um histórico persistente de descendentes. O suporte varia por provedor; Kimi e OpenCode podem mostrar a sessão principal sem observação compatível de descendentes. O mapa não lê transcrições de conversas, controla filhos individualmente nem calcula tokens por agente a partir dos limites de uso da conta.
Restauração e uso
- Os layouts dos terminais ativos são persistidos entre navegação e reinicializações do aplicativo.
- A retomada de uma conversa após reiniciar depende do provedor. O LaraEnv valida os metadados locais do provedor antes de oferecer a retomada; se estiverem ausentes ou desatualizados, inicie uma sessão nova.
- A barra inferior exibe uso apenas quando o LaraEnv tem um leitor local compatível. Estados sem suporte, indisponíveis, desatualizados ou desconectados são identificados em vez de estimados.
Limitações atuais
- Abas de agentes ainda não podem ser destacadas para um segundo processo do LaraEnv. Abas locais, de projeto e SSH mantêm o suporte normal a destaque.
- As capacidades variam conforme o provedor e a versão instalada, principalmente em retomada e informação de uso.
- As notificações ficam no inbox interno do LaraEnv. A entrega por notificações nativas do Windows está temporariamente indisponível enquanto é redesenhada para builds assinadas.
- Não desative nem redefina o recurso experimental enquanto houver agentes ou servidores de desenvolvimento de worktrees em execução; o LaraEnv bloqueia isso para não deixar recursos órfãos.