convez.ai
PluginAutomaçãoIntermediário
JuliusBrussee

Caveman

JuliusBrussee/caveman

Comprime prosa técnica em 75%, mantém 100% de precisão

Ver no GitHub
ExcelentePluginScore · de 0 a 100

MCP server que comprime descrições de ferramentas e saídas de texto usando regras de simplificação extrema, reduzindo ~75% de tokens sem perder precisão técnica. Mantém a qualidade das explicações enquanto fala de forma telegráfica e direta.

Instalação

$npx convez-ai JuliusBrussee/caveman

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
121 mil
Forks
7,1 mil
Acompanhando
259
Saúde
71%
Último commit
há 1 dia
Versão
v4.1.0
Issues abertas
100
Contribuidores
29

Casos de uso

  • Reduzir consumo de tokens em agents e skills do Claude
  • Otimizar custo de processamento em aplicações com muitas chamadas de IA
  • Manter clareza técnica com menos palavras em documentação e descrições

Veredito

Solução pragmática para quem precisa economizar tokens sem sacrificar compreensão. Funciona bem como proxy MCP, especialmente útil em fluxos com volume alto de chamadas, mas requer aceitação do estilo 'caveman' de comunicação.

README em português


Uma Claude Code skill/plugin (também Codex, Gemini, Cursor, Windsurf, Cline, Copilot e mais 30+) que faz o agente falar como cavernícola — corta ~75% dos tokens de saída, mantendo a precisão técnica completa. Cérebro ainda grande. Boca pequena.

Antes / Depois

🗣️ Claude Normal (69 tokens)

"A razão pela qual seu componente React está sendo re-renderizado é provavelmente porque você está criando uma nova referência de objeto em cada ciclo de renderização. Quando passa um objeto inline como prop, a comparação rasa do React vê-o como um objeto diferente toda vez, o que dispara um re-render. Eu recomendaria usar useMemo para memoizar o objeto."

Claude Cavernícola (19 tokens)

"Nova ref de objeto cada render. Prop inline = nova ref = re-render. Envolver com useMemo."

🗣️ Claude Normal

"Com certeza! Eu adoraria ajudar você com isso. O problema que você está enfrentando é mais provavelmente causado pelo seu middleware de autenticação não validar corretamente a expiração do token. Deixe-me dar uma olhada e sugerir uma correção."

Claude Cavernícola

"Bug no middleware de auth. Verificação de expiração do token usa < em vez de <=. Correção:"

Mesma correção. 75% menos palavras. Cérebro ainda grande.

┌─────────────────────────────────────┐
│  TOKENS SAVED          ████████ 75% │
│  TECHNICAL ACCURACY    ████████ 100%│
│  SPEED INCREASE        ████████ ~3x │
│  VIBES                 ████████ OOG │
└─────────────────────────────────────┘

Escolha seu nível de grunhido — lite (remove encheu), full (padrão cavernícola), ultra (telegráfico) ou wenyan (chinês clássico, até mais curto). Uma única opção de comando. O custo cai para sempre.

Fale sua língua. Cavernícolas mantêm seu idioma. Você escreve em português, o grunhido do cavernícola é em português. Espanhol, francês, igual. Comprime a estilo, não a linguagem. Código, comandos e strings de erro permanecem exatos.

"Nova ref de objeto cada render. Prop inline = nova ref = re-render. Envolver com useMemo."

Gostou dessa pegadinha? Agora pegue o agente inteiro — caveman-code

Esta skill encolhe o que o agente diz. caveman-code encolhe tudo — agente de codificação terminal completo, cavernícola do topo ao fundo. ~2× menos tokens que Codex em tarefas idênticas. 20+ provedores · modo plano · loop objetivo autopilot · MIT.

npm install -g @juliusbrussee/caveman-code

▶ Teste caveman-code agora → — por que usar muitos tokens quando o agente inteiro economiza

Instalação

Uma linha. Encontre cada agente. Instale para cada um.

# macOS / Linux / WSL / Git Bash
curl -fsSL https://raw.githubusercontent.com/JuliusBrussee/caveman/main/install.sh | bash

# Windows (PowerShell 5.1+)
irm https://raw.githubusercontent.com/JuliusBrussee/caveman/main/install.ps1 | iex

~30 segundos. Precisa de Node ≥18. Pule os agentes que você não tem. Seguro re-executar.

Gatilho: digite /caveman ou diga "falar como cavernícola". Pare com "modo normal".

Um agente apenas, comando manual, ou qualquer um dos 30+ outros agentes → INSTALL.md. Instalação quebra? Abra o agente, diga "Leia CLAUDE.md e INSTALL.md, instale caveman para mim." O agente corrige seu próprio cérebro.

O Que Você Obtém

SkillO quê
/caveman [lite|full|ultra|wenyan]Comprime cada resposta. Níveis persistem até o fim da sessão.
/caveman-commitMensagens de Conventional Commit, ≤50 char no assunto. Por que sobre o quê.
/caveman-reviewComentários PR em uma linha: L42: 🔴 bug: user null. Add guard.
/caveman-statsUso real de tokens da sessão + economia vitalícia + USD. Linha tweetável via --share.
/caveman-compress <file>Reescreve arquivo de memória (ex. CLAUDE.md) em fala cavernícola. Corta ~46% dos tokens de entrada a cada sessão. Código/URLs/caminhos preservados byte-a-byte.
caveman-shrinkMiddleware MCP. Envolve qualquer servidor MCP, comprime descrições de ferramentas. npm.
cavecrew-*Subagentes cavernícolas (investigador/construtor/revisor). ~60% menos tokens que o vanilla, contexto principal dura mais tempo.

Emblema de statusline — Claude Code mostra [CAVEMAN] ⛏ 12.4k (tokens salvos vitalícios). Atualiza a cada execução /caveman-stats. Defina CAVEMAN_STATUSLINE_SAVINGS=0 para silenciar.

Ativação automática em todas as sessões: Claude Code, Codex, Gemini (integrado). Cursor / Windsurf / Cline / Copilot recebem arquivos de regras sempre-ativos via --with-init. Outros agentes acionam com /caveman por sessão. Matriz completa de recursos em INSTALL.md.

Benchmarks

Token contagem real da API do Claude. Redução média de 65% na saída em 10 prompts (faixa: 22-87%).

TarefaNormalCavemanSalvo
Explicar bug de re-renderização do React118015987%
Corrigir expiração de token no middleware auth70412183%
Configurar pool de conexão PostgreSQL234738084%
Explicar rebase vs merge do git70229258%
Refatorar callback para async/await38730122%
Arquitetura: microsserviços vs monolito44631030%
Revisão de PR por problemas de segurança67839841%
Docker build multi-estágio104229072%
Debugar condição de corrida no PostgreSQL120023281%
Implementar error boundary do React345445687%
Média121429465%

Dados brutos e script de reprodução: benchmarks/. O conjunto de avaliação de três braços (baseline / terse / skill) está em evals/ — caveman comparado contra Answer concisely. não contra o padrão verboso, então a diferença é honesta.

caveman-compress receipts (arquivos reais de memória):

ArquivoOriginalComprimidoSalvo
claude-md-preferences.md70628559.6%
project-notes.md114553553.3%
claude-md-project.md112263643.3%
todo-list.md62738838.1%
mixed-with-code.md88856036.9%
Média89848146%

[!IMPORTANT] Caveman afeta apenas tokens de saída — tokens de pensamento/raciocínio intocados. Caveman não faz o cérebro menor. Caveman torna a boca menor. A maior vitória é legibilidade e velocidade, economia de custo um bônus.

Um artigo de março de 2026 "Brevity Constraints Reverse Performance Hierarchies in Language Models" descobriu que restringir grandes modelos a respostas breves melhorou a precisão em 26 pontos em certos benchmarks. Verboso nem sempre é melhor. Às vezes menos palavras = mais correto.

Como Funciona

  1. Instale o arquivo de skill drop no agente.
  2. O skill diz ao agente: elimine enfeites, mantenha substância, use fragmentos.
  3. Para Claude Code, o hook também escreve um pequeno arquivo flag em cada sessão — o agente vê a flag e fala como caveman desde a primeira mensagem. Não é necessário dizer /caveman.
  4. O comando de estatísticas lê o log da sessão do Claude Code, conta tokens salvos e escreve o número na statusline.
  5. A sub-skill caveman-compress reescreve arquivos de memória (CLAUDE.md, notas do projeto) para que cada início de sessão comece com um contexto menor. Salva tokens para sempre, não apenas uma resposta.

Detalhes sobre o mantenedor (arquitetura do hook, propriedade de arquivo, sincronização CI) estão em CLAUDE.md.

Lobster, Encontre Rock 🦞

OpenClaw o gateway auto-hospedado. Uma caixa, muitos agentes dentro (Claude Code, Codex, Pi, OpenCode), conectados ao seu Slack / Discord / iMessage / Telegram / qualquer coisa. Slogan: "The lobster way." Lobster forte. Lobster inteligente. Lobster também fala muito.

Caveman ensina lobster brevidade — mesmo instalador canônico, escopo para um agente:

# macOS / Linux / WSL
curl -fsSL https://raw.githubusercontent.com/JuliusBrussee/caveman/main/install.sh | bash -s -- --only openclaw

# Windows (PowerShell): no Node? install Node ≥18 first, then
npx -y github:JuliusBrussee/caveman -- --only openclaw

Duas coisas acontecem, não mais:

  1. Skill drop em ~/.openclaw/workspace/skills/caveman/SKILL.md — frontmatter correto de especificação (version, always: true), descobrível por openclaw skills list. Skill não injeta automaticamente (OpenClaw carrega skill sob demanda) — é por isso que também fazemos o passo 2.
  2. SOUL.md nudge. Pequeno bloco delimitado por marcador anexado a ~/.openclaw/workspace/SOUL.md. OpenClaw injeta SOUL.md em todas as voltas sob "Project Context" (12K-arquivo, 60K total — bloco bem abaixo). Lobster breve desde a primeira mensagem. Sem /caveman por sessão. Sem reclame.
~/.openclaw/workspace/
├── skills/caveman/SKILL.md   ← full ruleset, on-demand load
└── SOUL.md                    ← <!-- caveman-begin --> ... <!-- caveman-end -->
                                  ↑ auto-inject every turn

Caminho de workspace personalizado? OPENCLAW_WORKSPACE=/your/path antes do comando. Desinstalar: mesma linha única com --uninstall — pasta skill sumiu, bloco SOUL.md arrancado limpo, seu outro conteúdo de workspace permanece intocado. Re-execuções idempotentes (frontmatter não duplamente anexado, bloco marcador não duplicado).

Garra do lobster ainda afiada. Boca do lobster agora pequena. Cérebro ainda grande.

Caveman Ecosystem

Cinco ferramentas. Uma filosofia: agent do more with less.

RepoO que é
caveman (você aqui)Compressão de saída — por que usar muitos tokens quando poucos bastam
caveman-codeAgente de codificação no terminal inteiro — por que usar muitos tokens quando o agente todo pode economizar
cavememMemória entre agentes — por que um agente esquece quando outro pode lembrar
cavekitLoop de build impulsionado por especificações — por que o agente adivinha quando ele já sabe
cavegemmaGemma 4 31B fine-tuned em pares caveman — por que promptar cada turno quando os pesos lembram

Compose: cavekit impulsiona o build, caveman comprime o que o agente diz, cavemem comprima o que o agente lembrança, cavegemma assa a compressão nos pesos, e caveman-code entrega tudo como um único agente de terminal. Uma pedra. Duas pedras. Três pedras. Quatro pedras. Cinco pedras. É isso aí.

Mais Habilidade do Mesmo Buraco

Caveman tem irmãos. JuliusBrussee/skills — cinco habilidades, uma instalação, funciona no Claude Code, Cursor, Gemini, Cline, Copilot e 40+ agentes:

SkillO que é
cavemanEssa aqui. Fale menos, diga mais.
grill-meO agente "grei" seu plano antes você construir a coisa errada. Verifica o quanto você sabe primeiro — sem condescendência, nem babá-que-manda-bem.
interface-kitConstrua UI que pareça boa, carregue rápido e funcione para todos.
junior-to-seniorPassada de revisão adversarial. Saída do junior entra, saída do senior sai.
loop-factoryLoop de tarefa impulsionado por especificações — inbox → ativo → arquivo, porta de revisão entre eles.
npx skills@latest add JuliusBrussee/skills

Um comando. Cinco habilidades. Cave bem abastecido.

Links

  • INSTALL.md — matriz completa de instalação, todas as flags, detalhes por agente
  • CONTRIBUTING.md — como enviar patches
  • CLAUDE.md — guia do mantenedor (propriedade de arquivos, arquitetura de hooks, CI)
  • docs/ — guias extras (instalação no Windows, etc.)
  • Issues — bugs, recursos e comportamentos estranhos

Dê uma Estrela a Este Repositório

Caveman economiza seus tokens, economiza seu dinheiro. Dar estrela custa zero. Troca justa. ⭐

Star History Chart

Também de Julius Brussee

  • Revu — app de estudo local-first para macOS com repetição espaçada FSRS. revu.cards

Patrocinadores

Caveman é gratuito para sempre. O patrocinador mantém a pedra afiada.

Quer uma pedra aqui também? Patrocine o caveman.

Licença

MIT — gratuito como um mamute de massa na planície aberta.

Ver o original no GitHub

Bom para

Relacionados