Auditoria segura de contexto para Claude Code, Codex, Antigravity, OpenCode, Cursor, Gemini CLI, GitHub Copilot, Cline e MiniMax Code.
Baixar a release · Ver o código · Matriz de harnesses
Esta versão separa a skill portátil do comportamento específico de cada harness. O mesmo pacote pode ser descoberto por vários agentes, mas só altera uma configuração quando conhece o formato, a versão e o rollback daquele ambiente.
O núcleo é conservador: diagnostica primeiro, mostra evidências, cria uma prévia com identificador e nunca transforma tamanho de arquivo em uma falsa economia de tokens.
| Função | Claude Code | Outros harnesses |
|---|---|---|
| Detectar ambientes disponíveis | Sim | Sim |
| Auditar projeto e instruções | Sim | Sim |
| Detectar stack | Sim | Sim |
| Contar skills detectáveis | Sim | Sim |
| Saída JSON para automação | Sim | Sim |
Prévia (plan) |
Sim | Sim, sem escrita |
| Aplicar configurações | Sim, quando elegível | Ainda não |
| Desfazer aplicação | Sim | Ainda não |
| Modo Direto | Sim, opt-in | Orientação manual |
| Telemetria | Nunca | Nunca |
- Reativar Tool Search somente quando existe uma desativação explícita e a compatibilidade é confirmada.
- Adicionar opcionalmente uma regra curta de Modo Direto em
.claude/rules. - Fazer backup, escrita atômica, validação e rollback com proteção contra conflitos e links simbólicos.
- Arquivos de instrução longos e possíveis repetições.
- Stack detectada por manifests do projeto.
- Skills encontradas nos diretórios suportados pelo host.
- Estado de descoberta da própria skill.
- Limites e próximos passos sem inventar consumo ou economia.
O Token Saver não troca modelos, não reduz thinking, não edita CLAUDE.md, não
cria .claudeignore, não compacta conversas automaticamente e não instala
plugins externos.
Baixe o ZIP da release mais recente para seu sistema, extraia e execute o binário. O pacote não exige Python ou Node.
token-saver detect --project .
token-saver install --harness claude --project .
token-saver install --harness codex --project .
Use --harness auto para escolher o primeiro ambiente detectado. Para uma
instalação em um projeto específico, prefira uma pasta de skill versionada pelo
projeto; para uso global, deixe o instalador usar o diretório pessoal.
Depois de instalar, abra uma nova sessão ou recarregue as skills do harness. As formas usuais são:
| Ambiente | Instalação global | Como chamar |
|---|---|---|
| Claude Code | ~/.claude/skills/token-saver |
/token-saver |
| Codex | ~/.agents/skills/token-saver |
$token-saver |
| Antigravity | ~/.gemini/antigravity/skills/token-saver |
peça uma auditoria |
| OpenCode | ~/.config/opencode/skills/token-saver |
use a skill token-saver |
| Cursor | ~/.cursor/skills/token-saver |
/token-saver |
| Gemini CLI | ~/.gemini/skills/token-saver |
/skills e ative |
| GitHub Copilot | ~/.copilot/skills/token-saver |
/token-saver |
| Cline | ~/.cline/skills/token-saver |
use a skill token-saver |
| MiniMax Code | plugin skills/token-saver |
ative o plugin |
No Claude Code, o fluxo principal é:
/token-saver
/token-saver auditar
/token-saver desfazer
/token-saver detalhes
/token-saver modo direto
No terminal, todos os hosts podem usar o CLI:
token-saver detect --json
token-saver audit --harness codex --project . --json
token-saver audit --harness opencode --project .
token-saver plan --harness claude --project . --json
token-saver apply --harness claude --project . --yes --expect ID_DA_PREVIA --json
token-saver undo --harness claude --project . --json
token-saver details
token-saver version
Opções comuns:
--project PASTA raiz do projeto analisado
--harness ID auto, claude, codex, antigravity, opencode, cursor,
gemini, copilot, cline ou minimax
--config-dir PASTA perfil do harness; útil para testes isolados
--json saída estruturada, sem segredos
--dry-run somente prévia
--yes autoriza uma prévia já revisada
--expect ID recusa aplicar se o ambiente mudou
--concise inclui o Modo Direto no plano do Claude Code
O diagnóstico lê arquivos e configurações locais. Ele não mede tokens de entrada, saída, cache, custo real ou a economia contrafactual. Uma alteração gravada não prova ganho na sessão. Verifique o painel, comando de contexto ou relatório de uso oferecido pelo seu próprio harness.
O modo padrão é leitura. JSON inválido, configuração gerenciada, versão não confirmada ou conflito interrompem a aplicação. No Claude Code, o histórico fica fora do projeto, as escritas são atômicas e o rollback preserva edições posteriores em chaves não relacionadas. Consulte recovery e details antes de remover qualquer backup pendente.
go test ./...
go vet ./...
python scripts/package.py --out dist
O repositório mantém um núcleo em Go, a skill portável em skill/ e adaptadores
de descoberta por harness em harness.go e portable_audit.go. A matriz completa
fica em skill/references/harnesses.md.
MIT. Veja CHANGELOG, VALIDATION e a versão em English.