rolandtolnay/session-index

O que session-index faz?

Indexa conversas do Claude Code no SQLite via hooks, com resumos de LLM local e uma habilidade de busca que permite ao Claude lembrar de sessões anteriores.

Visão Geral

Esta skill cria um índice persistente de sessões do Claude Code. Cada vez que uma sessão termina, ela é resumida por um modelo de linguagem local (LLM) e armazenada em um banco de dados SQLite. Posteriormente, uma skill de busca dedicada pode consultar esse índice, permitindo que o Claude recupere contexto de trabalho anterior.

Funcionalidades

• Indexação Automática: Hooks pre e post capturam metadados da sessão e geram resumos automaticamente.
• Resumos com LLM Local: Usa um modelo local (ex.: Ollama, LM Studio) para criar resumos sem custos de API externa.
• Busca Integrada: Skill de busca permite que o Claude pesquise por palavras-chave, datas ou tópicos.
• Persistência SQLite: Dados ficam armazenados localmente em ~/.claude-sessions/sessions.db.

Como Funciona

1. Hook de Início: Ao iniciar uma sessão, um registro é criado no SQLite com timestamp e ID único.
2. Hook de Término: Ao finalizar, o conteúdo da sessão é enviado a um LLM local para sumarização.
3. Armazenamento: O resumo e os metadados são salvos no banco.
4. Busca: A skill session-search consulta o banco e retorna resumos relevantes para o prompt atual do Claude.

Configuração

Para usar, adicione ao seu ~/.claude/skills.json:

{
  "skills": [
    {
      "name": "session-index",
      "source": "rolandtolnay/session-index",
      "config": {
        "llm_endpoint": "http://localhost:11434/api/generate",
        "model": "llama3.2:1b",
        "db_path": "~/.claude-sessions/sessions.db"
      }
    }
  ]
}

Requisitos

• Claude Code CLI
• LLM local compatível com API OpenAI (ex.: Ollama, LM Studio, llamafile)
• SQLite (já incluído no macOS/Linux)

Licença

MIT