Sessões de IA

Sessões e cópia isolada

IA → Painel de sessões... abre um cockpit que lista, num cartão por sessão, cada terminal de CLI de IA aberto em qualquer janela do LightNote — com uma bolinha colorida do estado, o nome da CLI, a janela e selos para o que precisa de atenção (envios agendados, cópia isolada). O duplo clique foca o terminal; o menu ⋯ do cartão (ou o botão direito) traz Revisar as mudanças daquela sessão (abre a tela de revisão já com a base no checkpoint criado quando a sessão começou — veja Revisar mudanças) e Agendar um envio. É a forma de acompanhar várias sessões de "vibe coding" ao mesmo tempo sem se perder entre as janelas.

Ao abrir uma CLI de IA como terminal num repositório Git, o LightNote grava automaticamente um checkpoint (rótulo "Sessão …"), para que você possa depois ver e reverter exatamente o que aquela sessão alterou. O recurso pode ser desligado em Configurações → Geral → Recursos.

Cópia isolada (worktree): em pastas com Git, a IA pode trabalhar numa cópia separada dos seus arquivos (um branch próprio); você liga isso por pasta em Configuração do Espaço → Integrações. Desligado (o padrão), ela trabalha direto nos seus arquivos, com o checkpoint para desfazer. Com a cópia, o que a IA muda não aparece nos seus arquivos até você trazer: uma faixa no topo do terminal da sessão diz isso e conta os arquivos pendentes, e a barra de status mostra Cópia da IA enquanto a cópia existir. Trazer para os meus arquivos… aplica as mudanças da IA como alterações ainda não commitadas (o que você mudou nos mesmos arquivos é preservado; se os dois mexeram na mesma parte, nada é alterado e você pode levar a sua versão para a IA resolver). Atualizar a cópia… leva para a cópia o que mudou nos seus arquivos, inclusive o que você ainda não commitou — a cópia já nasce assim, e ao abrir uma sessão numa cópia desatualizada o LightNote oferece atualizar. Ao encerrar uma sessão com trabalho pendente, ele pergunta se você quer revisar, trazer ou descartar; e, ao abrir a pasta depois, uma faixa na janela lembra do que ficou. Descartar a cópia… apaga a cópia e o branch, dizendo antes quantos arquivos se perdem.

Ocioso, contexto e hibernar

Aviso de sessão ociosa. Quando uma CLI de IA fica ociosa (terminou ou está aguardando você), o LightNote mostra uma notificação; clicar nela abre a revisão das mudanças daquela sessão. Assim você pode iniciar a tarefa e sair de perto. Pode ser desligado em Configurações → Terminal.

Arquivo de contexto do espaço. Ao abrir uma CLI de IA numa pasta sem um arquivo de contexto (CLAUDE.md ou AGENTS.md), o LightNote oferece gerar um — e você pode fazê-lo a qualquer momento por IA → Gerar arquivo de contexto do espaço.... Um bom arquivo de contexto descreve a estrutura e as convenções do espaço e ajuda a IA a errar menos, sem você reexplicar tudo a cada sessão. Se houver um provedor de IA configurado, o conteúdo é gerado por ele; senão, um esqueleto para você preencher.

Hibernar sessões ociosas. Uma CLI de IA parada continua ocupando memória (a conversa e o cliente do modelo). Em Configurações → Terminal você pode definir um tempo de silêncio após o qual o LightNote encerra o processo e o retoma sozinho quando você voltar àquela aba — o histórico do terminal continua na tela. Vem ligado, com 30 minutos: três sessões paradas do Claude Code chegaram a segurar mais de 1 GB na medição; e só vale para sessões em cópia isolada cujas CLIs sabem retomar a conversa da pasta (hoje Claude Code e Antigravity), porque sem isso a retomada traria a conversa de outra sessão. Uma sessão com envio agendado nunca hiberna. E o que volta é a conversa, não a tela da ferramenta: um texto digitado e ainda não enviado se perde.

Atividade e busca por significado

Aba Atividade. A tabela mostra o que está rodando agora; a aba Atividade guarda o histórico: cada vez que um agente terminou o turno, começou numa cópia isolada ou hibernou, com a data e um trecho da última resposta. Os itens não lidos aparecem em negrito e contam no sino do painel Atividades, na barra de status — assim quem saiu de perto do computador vê o que perdeu, já que as notificações são passágeiras. Abrir a aba marca tudo como lido; um clique duplo leva de volta à sessão. O encerramento da sessão também vira evento — inclusive quando a CLI sai sozinha —, então uma sessão que morreu enquanto você estava longe deixa rastro em vez de simplesmente sumir. Se a sessão do evento já não estiver aberta, o clique duplo diz isso em vez de não fazer nada.

Buscar por significado. Quando a busca não encontra nenhuma ocorrência literal, aparece ao lado do resultado a opção Buscar por significado: em vez de casar palavras, o LightNote procura as notas que falam do mesmo assunto — útil quando você lembra da ideia, mas não do termo que escreveu. Também há um alternador ~ ao lado dos outros, para ir direto. Neste modo, regex, palavra inteira, maiúsculas, filtro de arquivos e o Substituir somem: nenhum deles se aplica a uma busca por semelhança. O recurso depende do reforço semântico (embeddings) em Configurações → Geral → Recursos; sem ele, o botão leva à tela para ligá-lo. Na primeira vez em cada pasta, o LightNote diz quantos trechos precisará indexar e pede confirmação — essa indexação é cobrada pelo seu provedor e acontece uma vez só; depois, cada busca custa apenas a consulta.

Calcular os vetores no seu computador. Os embeddings não precisam vir de um provedor pago: no assistente Configurar IA, o caminho Busca por significado pergunta onde calcular — na nuvem, por uma IA conectada que calcula embeddings, ou no seu computador, de graça e sem que nada saia da máquina. Indexar no computador não tem custo em dinheiro, mas leva tempo; o aviso da primeira indexação diz quanto, em vez de falar em preço. Veja Busca por significado na nuvem ou no computador.

A indexação à vista. Enquanto indexa, a aba Pesquisar mostra a barra de espera e a etapa — Contando o que há para indexar…, Preparando os documentos…, Indexando 40 de 120 arquivos… — com Parar ao lado; a mesma tarefa aparece no painel Atividades, e parar num lugar para no outro. A contagem da primeira vez roda sem travar a janela, e o que já foi indexado continua valendo.

Quando algo dá errado, a tela diz o quê. A chave recusada pelo provedor manda conferir as Configurações; um erro interno avisa que o índice anterior continua valendo; uma pasta sem notas nem documentos diz isso em vez de mostrar uma lista vazia. Um documento que não pôde ser lido (corrompido, sem memória para abri-lo ou num formato cujo leitor falhou) não derruba a indexação: fica de fora, e a aba avisa N documentos não puderam ser lidos — ver quais. O link abre a lista com o motivo em cada linha; o detalhe técnico aparece na dica, ao parar o mouse sobre a linha. O Ver quais do painel Atividades abre a lista na janela que tem aquela pasta aberta (ou na janela em que você clicou), sem trocar a pasta em que a aba Pesquisar busca. A lista só existe enquanto o app está aberto: depois de reiniciá-lo, a aba diz que ela não está mais disponível, e uma nova busca por significado naquela pasta conta de novo.