Caveman
JuliusBrussee/caveman
Comprime prosa técnica em 75%, mantém 100% de precisão
Ver no GitHubMCP 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/caveman1 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
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
| Skill | O quê |
|---|---|
/caveman [lite|full|ultra|wenyan] | Comprime cada resposta. Níveis persistem até o fim da sessão. |
/caveman-commit | Mensagens de Conventional Commit, ≤50 char no assunto. Por que sobre o quê. |
/caveman-review | Comentários PR em uma linha: L42: 🔴 bug: user null. Add guard. |
/caveman-stats | Uso 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-shrink | Middleware 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%).
| Tarefa | Normal | Caveman | Salvo |
|---|---|---|---|
| Explicar bug de re-renderização do React | 1180 | 159 | 87% |
| Corrigir expiração de token no middleware auth | 704 | 121 | 83% |
| Configurar pool de conexão PostgreSQL | 2347 | 380 | 84% |
| Explicar rebase vs merge do git | 702 | 292 | 58% |
| Refatorar callback para async/await | 387 | 301 | 22% |
| Arquitetura: microsserviços vs monolito | 446 | 310 | 30% |
| Revisão de PR por problemas de segurança | 678 | 398 | 41% |
| Docker build multi-estágio | 1042 | 290 | 72% |
| Debugar condição de corrida no PostgreSQL | 1200 | 232 | 81% |
| Implementar error boundary do React | 3454 | 456 | 87% |
| Média | 1214 | 294 | 65% |
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):
| Arquivo | Original | Comprimido | Salvo |
|---|---|---|---|
claude-md-preferences.md | 706 | 285 | 59.6% |
project-notes.md | 1145 | 535 | 53.3% |
claude-md-project.md | 1122 | 636 | 43.3% |
todo-list.md | 627 | 388 | 38.1% |
mixed-with-code.md | 888 | 560 | 36.9% |
| Média | 898 | 481 | 46% |
[!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
- Instale o arquivo de skill drop no agente.
- O skill diz ao agente: elimine enfeites, mantenha substância, use fragmentos.
- 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. - O comando de estatísticas lê o log da sessão do Claude Code, conta tokens salvos e escreve o número na statusline.
- A sub-skill
caveman-compressreescreve 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:
- Skill drop em
~/.openclaw/workspace/skills/caveman/SKILL.md— frontmatter correto de especificação (version,always: true), descobrível poropenclaw skills list. Skill não injeta automaticamente (OpenClaw carrega skill sob demanda) — é por isso que também fazemos o passo 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/cavemanpor 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.
| Repo | O que é |
|---|---|
| caveman (você aqui) | Compressão de saída — por que usar muitos tokens quando poucos bastam |
| caveman-code | Agente de codificação no terminal inteiro — por que usar muitos tokens quando o agente todo pode economizar |
| cavemem | Memória entre agentes — por que um agente esquece quando outro pode lembrar |
| cavekit | Loop de build impulsionado por especificações — por que o agente adivinha quando ele já sabe |
| cavegemma | Gemma 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:
| Skill | O que é |
|---|---|
| caveman | Essa aqui. Fale menos, diga mais. |
| grill-me | O 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-kit | Construa UI que pareça boa, carregue rápido e funcione para todos. |
| junior-to-senior | Passada de revisão adversarial. Saída do junior entra, saída do senior sai. |
| loop-factory | Loop 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. ⭐
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.