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.
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.