artubss Claude Code Sessions
Plugin de inteligência de sessão para Claude Code. Lê os arquivos de sessão em JSONL que Claude Code gera em ~/.claude/projects/ e os torna pesquisáveis e analisáveis.
O Que Faz
Claude Code registra cada sessão em um arquivo JSONL — mensagens, chamadas de ferramentas, contagens de tokens, diffs, tarefas. Este plugin lê esses arquivos e oferece duas interfaces. A maioria das operações é somente leitura; skills de exclusão e limpeza podem remover arquivos de sessão quando explicitamente invocados.
11 skills usáveis diretamente no Claude Code:
| Skill | Propósito |
|---|---|
/session-search "query" |
Busca de texto completo em todas as sessões |
/session-stats |
Uso de tokens, distribuição de modelos, análise de ferramentas |
/session-list |
Lista sessões ordenadas por recência, tamanho ou duração |
/session-detail |
Análise profunda de uma sessão específica |
/session-diff |
Compare duas sessões — arquivos, ferramentas, tópicos |
/session-timeline |
Visualização cronológica de sessões em um projeto |
/session-resume |
Gere um prompt de recuperação de contexto a partir de qualquer sessão |
/session-tasks |
Encontre tarefas pendentes e órfãs em todas as sessões |
/session-export |
Exporte uma sessão como markdown limpo |
/session-cleanup |
Encontre sessões vazias, minúsculas ou desatualizadas |
/session-delete |
Delete sessões e suas tarefas associadas |
Dashboard web em localhost:3000 com quatro visualizações: Dashboard (estatísticas resumidas), Sessions (tabela ordenável com operações em massa), Search (busca de texto completo com snippets de contexto), Tasks (agrupadas por status com detecção de órfãs).
Instalação
/plugin marketplace add apappascs/claude-code-sessions
/plugin install claude-code-sessions@claude-code-sessions
Sem chaves de API. Sem configuração. Sem dependências de runtime. Lê o que já está no disco.
Para o dashboard:
bun run ui
# → http://localhost:3000
Arquitetura
Os mesmos módulos TypeScript alimentam skills, dashboard e CLI:
lib/formatters.ts — utilitários puros, sem I/O
lib/session-parser.ts — analisa um arquivo JSONL em dados estruturados
lib/session-store.ts — verifica todas as sessões, agrega, pesquisa
ui/server.ts — endpoints HTTP + entrega de arquivos estáticos
Cada arquivo lib funciona como um CLI autônomo:
bun run lib/session-store.ts list --sort recency --limit 10
bun run lib/session-store.ts search "database migration" --since 2025-01-01
bun run lib/session-parser.ts stats path/to/session.jsonl
Casos de Uso
- Encontre a sessão onde você resolveu um problema específico semanas atrás
- Veja quais projetos consomem mais tokens
- Acompanhe tarefas pendentes em todas as sessões e projetos
- Retome uma sessão anterior com contexto completo
- Compare como duas sessões abordaram o mesmo problema
- Exporte transcrições de sessão para documentação
Links
- GitHub: github.com/apappascs/claude-code-sessions
- Licença: MIT