Sessões
Uma sessão é uma conversa contínua com o agente: o histórico de mensagens, as ações que ele tomou e o estado de trabalho. É a unidade que você abre, fecha e retoma.
O ciclo de uma sessão
Cada turno é uma rodada: você escreve, o modelo raciocina, eventuais ferramentas rodam (editar arquivos, comandos, skills) e a resposta volta em streaming. A sessão acumula esses turnos.
Contexto e compactação
O modelo tem uma "janela de contexto" finita. Conforme a conversa cresce, o Imaginne gerencia o contexto por limite, não por número de turnos: quando o contexto se aproxima do limite, ele compacta automaticamente partes antigas para manter a conversa fluindo sem perder o fio.
- Você pode acompanhar o uso de contexto na barra de status (Desktop/TUI mostram
ctx:usado/limite). - Limpar o contexto começa um raciocínio do zero (próxima chamada ao modelo "esquece" o histórico) sem apagar a transcrição visível, a memória nem os ajustes.
- Limpar a conversa descarta o histórico efêmero, mas preserva o estado persistente (workspace, memória, skills, modelo, autonomia).
Onde a sessão vive
- Superfícies locais (Desktop, TUI, VS Code). A sessão é persistida em arquivos locais (com um índice local). Você pode fechar o app e retomar a conversa exatamente de onde parou. No Desktop, cada projeto pode ter várias sessões; no terminal, há um catálogo local de sessões (
/sessions). - Chat no navegador. A sessão fica no servidor, vinculada à sua organização e ao seu usuário, e é restaurada quando você reabre a conversa. Sessões hospedadas expiram após períodos de inatividade.
Execução em segundo plano (chat web)
No chat no navegador, a execução pertence ao servidor, não à aba do navegador. Isso muda o que você pode fazer durante uma resposta:
- Fechar a aba, perder a conexão ou trocar de máquina não cancela nada. Ao reabrir a conversa, o que foi produzido enquanto você estava fora já está lá.
- Você pode trabalhar em várias conversas ao mesmo tempo. Trocar de conversa não interrompe a execução anterior; uma bolinha de status na lista mostra o que está executando, na fila, concluído com resultado novo ou falhou.
- O limite é de 10 execuções ativas por usuário — ao passar disso, o chat pede que você aguarde uma terminar.
- Para interromper de fato, use o botão parar no composer da conversa.
Nas superfícies locais o modelo é outro: o agente roda no seu app, e você aguarda ou cancela o turno em curso antes de trocar de sessão.
Retomar, renomear, arquivar
As superfícies oferecem operações de sessão equivalentes:
| Ação | Desktop | Terminal (TUI) | Chat no navegador |
|---|---|---|---|
| Listar sessões | menu de sessão (cabeçalho) | /sessions | barra lateral + busca (⌘/Ctrl+K) |
| Nova sessão | + Nova sessão | /sessions new <título> | ＋ Novo chat |
| Trocar de sessão | clicar na lista | /sessions switch <id> | clicar na lista |
| Renomear | Renomear atual | /sessions rename <id> <título> | menu ⋯ → Renomear |
| Arquivar | Arquivar atual | /sessions archive <id> | menu ⋯ → Arquivar |
| Organizar em pastas | — | — | Projetos |
Nas superfícies locais, você não troca de sessão enquanto o agente está respondendo — cancele ou aguarde o término primeiro; e não dá para arquivar a sessão ativa. No chat web essa restrição não existe: a execução continua no servidor enquanto você abre outra conversa.
O que a sessão guarda
Além das mensagens, a sessão preserva os seus ajustes de trabalho: modelo selecionado, autonomia, modo de execução e nível de detalhe. Ao retomar, você encontra tudo como deixou.
Veja também
Esta página ajudou?
Reportar um problema nesta páginaNão envie senhas, chaves, tokens ou dados de clientes.