farmcan/kage

O que kage faz?

Memória local para agentes de codificação de IA. Encontre, reproduza, bifurque, conecte e despache sessões do Claude Code, Codex e Qoder.

Visão Geral

O kage armazena e gerencia o histórico de sessões de agentes de IA de codificação. Ele permite que você:

• Encontre sessões anteriores por consulta, projeto ou data
• Reproduza sessões completas ou partes delas
• Bifurque sessões existentes para criar novas variações
• Conecte contexto entre diferentes ferramentas de IA
• Despache sessões para agentes específicos

Instalação

npm install -g @farmcan/kage
# ou
cargo install kage

Uso

Iniciar o serviço

kage serve

Capturar uma sessão

kage capture --agent claude-code --session-id abc123

Consultar o histórico

kage search "configuração de rota React"

Reproduzir uma sessão

kage replay --session-id abc123

Integração com CLI de Agentes

Claude Code

Adicione isso ao seu .claude.code.rc.json:

{
  "hooks": {
    "onSessionEnd": "kage capture --agent claude-code"
  }
}

Codex

Use a flag --post-process:

codex --post-process "kage capture --agent codex"

Qoder

Defina a variável de ambiente:

export QODER_HOOK="kage capture --agent qoder"

API REST

O serviço expõe uma API REST em http://localhost:8742:

Endpoint	Método	Descrição
/sessions	GET	Lista todas as sessões
/sessions	POST	Cria uma nova sessão
/sessions/:id	GET	Obtém detalhes de uma sessão
/sessions/:id	PUT	Atualiza uma sessão
/sessions/:id	DELETE	Remove uma sessão
/search	GET	Pesquisa sessões

Configuração

Variáveis de ambiente:

Variável	Padrão	Descrição
KAGE_PORT	8742	Porta do servidor HTTP
KAGE_DATA_DIR	~/.kage	Diretório de armazenamento de dados
KAGE_DB_PATH	~/.kage/db.sqlite	Caminho do banco de dados SQLite
KAGE_LOG_LEVEL	info	Nível de log (trace, debug, info, warn, error)

Armazenamento

Os dados são armazenados localmente em um banco SQLite em ~/.kage/db.sqlite. Cada sessão inclui:

• ID da sessão
• Nome do agente
• Metadados do projeto
• Carimbo de data/hora
• Histórico de conversas
• Arquivos contextuais
• Pontos de bifurcação

Bifurcação e Conexão

Para bifurcar uma sessão:

kage fork --session-id abc123 --new-session-id def456

Para conectar duas sessões:

kage bridge --from abc123 --to def456

Despacho

Enviar uma sessão para um agente específico:

kage dispatch --session-id abc123 --agent claude-code

Exemplo de Fluxo de Trabalho

1. Trabalhe em um problema com o Claude Code
2. O kage captura automaticamente a sessão
3. Mude para o Codex e use kage search para encontrar o contexto
4. Use kage replay para revisar a abordagem anterior
5. Use kage fork para criar uma nova abordagem
6. Conclua com o Qoder e use kage dispatch para compartilhar o resultado

Licença

MIT