Mibayy/token-savior

O que é?

Recursos principais

• 01Navegação pelo código no nível de símbolos, incluindo find_symbol e dependentes no grafo de chamadas
• 02Memória persistente armazenada no SQLite, com busca de texto completo e busca vetorial opcional
• 03Reescritor de Bash PreToolUse que reduz a saída dos comandos antes que ela chegue ao modelo
• 0434 compactadores PostToolUse para git, executores de testes, CLIs de nuvem e Docker
• 05Perfis de ferramentas configuráveis e um comando `ts init` para Claude Code, Cursor, Gemini, Codex e OpenClaw

Casos de uso

• Trabalhar com uma base de código grande na qual o agente relê arquivos inteiros para encontrar pequenos trechos de código
• Manter decisões de arquitetura e anotações sobre correções de bugs disponíveis em várias sessões do Claude Code
• Reduzir o custo em tokens e a latência de um agente que navega repetidamente pelo código e executa testes
• Dar a ferramentas sem suporte a MCP, como Cursor ou scripts, acesso via shell à busca de símbolos por meio da CLI ts

Início rápido

1. 1

   Instale o pacote do PyPI com suporte a MCP

   pip install "token-savior-recall[mcp]"
2. 2

   Adicione o servidor à sua configuração do MCP (por exemplo, Claude Code), informando as raízes do seu workspace e o perfil

Antes de usar

• !Os principais números do benchmark foram divulgados pelo autor, e o repositório do harness não é público; por isso, não podem ser verificados de forma independente.
• !Usuários do Claude Code precisam definir alwaysLoad como true; caso contrário, as ferramentas ficam ocultas atrás do ToolSearch e raramente são usadas.
• !Os compactadores Bash do PostToolUse não reduzem os tokens do turno atual; somente o reescritor do PreToolUse faz isso.

Em coleções

Tópicos

Perguntas frequentes

O que é token-savior?

Servidor MCP para agentes de programação com IA que indexa código por símbolo e adiciona memória persistente e reescrita de comandos Bash para reduzir o uso de tokens. Token Savior é um servidor MCP que fica entre um agente de programação com IA, como o Claude Code, e sua base de código. Em vez de permitir que o modelo leia arquivos inteiros para responder a perguntas específicas, ele indexa o projeto por símbolo (funções, classes, imports e o grafo de chamadas), permitindo que o agente encontre uma definição ou seus dependentes por referência, sem precisar ler os arquivos por completo.

token-savior é gratuito? Qual é a licença?

token-savior é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

token-savior ainda é mantido?

Manutenção ativa. O último commit de token-savior foi em 15 de out. de 2026.

Para que posso usar token-savior?

Trabalhar com uma base de código grande na qual o agente relê arquivos inteiros para encontrar pequenos trechos de código Manter decisões de arquitetura e anotações sobre correções de bugs disponíveis em várias sessões do Claude Code Reduzir o custo em tokens e a latência de um agente que navega repetidamente pelo código e executa testes Dar a ferramentas sem suporte a MCP, como Cursor ou scripts, acesso via shell à busca de símbolos por meio da CLI ts

Como instalar token-savior?

Instale o pacote do PyPI com suporte a MCP: pip install "token-savior-recall[mcp]" Adicione o servidor à sua configuração do MCP (por exemplo, Claude Code), informando as raízes do seu workspace e o perfil

Onde consigo token-savior?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Mibayy/token-savior