Sessões

A aba Sessions reúne conversas de todos os agentes numa lista, das mais recentes às mais antigas. Você pode retomar na CLI do próprio agente, ler, buscar, exportar, nomear e excluir sessões. O lazyagents apenas lê os arquivos de sessão das CLIs; só os altera ao excluir uma sessão.

Conceitos

#

• Sessão: conversa com um agente, com a primeira mensagem como título, pasta de execução e horário da última atualização.
• Alias: nome que você dá a uma sessão. O lazyagents o guarda em arquivo próprio, nunca nos dados da CLI. O filtro pesquisa aliases e títulos.
• Sessão em execução: conversa ainda aberta por um processo do agente. Mostra ● e não pode ser excluída antes de você fechá-la.
• Índice de conversas: o lazyagents lê cada conversa uma vez e depois apenas o trecho acrescentado. Isso acelera a recarga de históricos grandes. O índice é um cache descartável (Arquivos).

Origem das sessões

#

Esses são os caminhos padrão. Agentes movidos por suas variáveis de configuração, como CLAUDE_CONFIG_DIR, CODEX_HOME, XDG_DATA_HOME ou OPENCODE_DB, são lidos na localização correspondente.

Claude Desktop e Hermes Agent não têm sessões locais legíveis pelo lazyagents. Outros recursos de cada agente estão na referência dos agentes.

Requisitos:

• OpenCode: exige sqlite3 no PATH para listar e ler sessões. Sem ele, os demais agentes continuam carregando e o erro identifica o binário ausente.
• Indicador de execução: no Linux, lê /proc diretamente. Nos demais sistemas, executa lsof uma vez por carga. Sem lsof, nenhuma sessão é marcada como em execução.

Na TUI

#

As teclas estão na referência; ? as mostra na interface. O painel lateral mostra pasta, ID e tokens da sessão quando o agente registra consumo, além do custo estimado para autenticação por chave de API. Custos registrados pelo próprio agente (Pi e Crush) aparecem sem ~. Crush registra custo, mas não os tokens da sessão inteira, então suas sessões não têm a linha de tokens.

Retomar uma sessão

#

Pressione enter. O lazyagents suspende a interface, executa a retomada na pasta da sessão e volta quando o agente sai. Se a pasta não existir mais, pede outra. Para escolher a pasta manualmente, use R. O campo aceita ~.

Para copiar o comando em vez de executá-lo, pressione c: a linha de estado mostra cd <pasta> && <comando>.

O binário do agente precisa estar no PATH. Agentes sem retomada pela CLI mostram um erro.

Ler uma conversa

#

v abre a conversa como registro: cada mensagem sua é um título numerado; cada turno do agente fica atrás de uma barra na cor dele. O turno mostra a resposta e as mensagens após o último comando. O trabalho anterior (progresso, raciocínio e comandos) fica recolhido numa linha ⋯ com contagens.

Para Claude Code, Codex, Pi, OpenCode e Crush, o leitor mostra o horário das mensagens e a duração do trabalho. Compactações, interrupções, mudanças de modelo e ramos do Pi (branch 2 of 3, seguido dos outros ramos) aparecem entre turnos. Comandos com / aparecem como foram digitados. Falhas recebem ✗; Codex não associa a falha à chamada, então seus comandos não recebem essa marca. Um resumo do Crush aparece como compactação.

Chamadas são mostradas pelo que fizeram: $ comando para shell, ✎ arquivo +3 −1 para edição com linhas adicionadas e removidas, texto discreto para leituras, buscas e consultas web, e ⎇ para subagentes, com contagem de chamadas quando o Claude Code guardou a conversa. A linha ⋯ conta arquivos editados. Planos propostos pelo agente (modo de planejamento do Claude Code) aparecem como documentos; tarefas aparecem como lista com contagem das concluídas. No leitor:

• n/N alternam entre suas mensagens. g/G vão ao começo e ao fim. A partir de 150 colunas, uma faixa à esquerda lista as mensagens com horários e marcas (✎ edição, ✗ falha, ⎇ subagente), destacando a atual.
• m alterna entre log (registro padrão), conversation (mensagens e respostas, sem etapas) e actions (mensagens e chamadas, sem mensagens de progresso: o que foi feito nos arquivos e shell).
• ]/[ escolhem o próximo ou anterior turno com etapas recolhidas, subagente ou ramo (▶). enter expande ou recolhe só o turno escolhido, ou abre a conversa do subagente/ramo. esc volta ao ponto anterior.
• e expande todas as etapas ou as recolhe novamente.
• t mostra comandos de ferramentas (❯) completos, um por linha, ou resumidos; também expande as etapas.
• r mostra raciocínio (💭) completo ou só a primeira linha; também expande as etapas.
• esc volta à lista.

Exportar para Markdown

#

No leitor, x grava em ~/.local/share/lazyagents/exports/ como <agent>-<id>-<timestamp>.md, com modo 0600. O arquivo tem cabeçalho com agente, data e pasta, e uma seção por turno, com comandos em lista e raciocínio em citações. Conversas vazias não são exportadas.

Buscar em todas as conversas

#

F pede uma palavra ou frase. A busca ignora diferenças entre maiúsculas e minúsculas e pesquisa, em paralelo, o texto completo de todas as sessões carregadas. Para Claude Code e Codex, arquivos que não podem conter o texto são descartados sem decodificação. A lista mostra só correspondências, com um trecho em torno da primeira ocorrência. esc limpa a busca.

/ é diferente: filtra a lista por agente, alias, título e nome da pasta sem abrir as conversas.

Nomear uma sessão

#

m pede um alias. Salvar vazio o remove. O alias aparece antes do título em todos os lugares, inclusive em lazyagents sessions.

Agrupar e filtrar

#

• g agrupa por projeto (nome da pasta) e agente.
• f alterna entre todos os agentes e cada agente individualmente.
• r recarrega do disco. Os arquivos não são monitorados automaticamente.

Excluir sessões

#

d exclui a sessão selecionada. Para várias, marque antes com space; sobre um cabeçalho de grupo, marca o grupo inteiro. A confirmação lista tudo antes da exclusão.

• Claude Code, Codex, Gemini CLI e Pi: o arquivo é copiado para ~/.local/share/lazyagents/backups/ como <file>.<timestamp> antes da remoção. Para restaurar, copie-o à pasta original e retire o sufixo de horário.
• OpenCode: primeiro salva opencode export <id> em ~/.local/share/lazyagents/backups/opencode-<id>.<timestamp>.json (0600), depois executa opencode session delete <id>. Se a exportação falhar, nada é excluído. Restaure com opencode import <file>.
• Crush: primeiro salva crush session show <id> --json, com sessão e mensagens, em ~/.local/share/lazyagents/backups/crush-<id>.<timestamp>.json (0600); depois executa crush session delete <id>, ambos com o diretório de dados da sessão. Falha no backup impede a exclusão. Crush não tem importação: o backup é um registro, não um arquivo recarregável.
• Sessões em execução: são recusadas; feche o agente antes.

Pela CLI

#

lazyagents sessions                          # todos os agentes, mais recentes primeiro
lazyagents sessions --agent codex --limit 20
lazyagents sessions --here                   # sessões iniciadas nesta pasta
lazyagents sessions --json | jq '.[0].id'    # id, título, alias, cwd, atualização e consumo

--json inclui tokens quando registrados pelo agente e cost_usd apenas para autenticação por chave de API. Retomada, leitura e exclusão são ações da TUI. As opções estão na referência da CLI.

Configuração

#

Sessions não tem seção própria em config.yaml. Para iniciar nessa aba, use startTab: sessions na seção tui: (configuração).

Arquivos

#

Limitações

#

• Custos estimados usam preços de tabela da API Claude (Pi usa seu custo registrado), cobrem apenas modelos Claude conhecidos e aparecem só para chaves de API: assinaturas não pagam por token. Veja as regras no guia de consumo.
• Formatos de sessão são privados e podem mudar entre versões das CLIs. Arquivos ilegíveis são ignorados, sem impedir os outros de carregar.
• OpenCode lista até 500 sessões e exclui sessões de subagentes da lista principal.