Caveman MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Three intensity modes: Lite / Full / Ultra (+ Classical Chinese)
~65% average output-token savings (repo benchmarks)
Sub-skills: /caveman-commit, /caveman-review, /caveman-compress
Cross-platform: Claude Code, Cursor, Codex, Gemini, Windsurf, Cline, Copilot
Eval suite in-repo showing accuracy preserved, not just shorter

Demo ao vivo

Como fica na prática

caveman-skill.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "caveman-skill": {
      "command": "claude",
      "args": [
        "plugin",
        "marketplace",
        "add",
        "JuliusBrussee/caveman"
      ],
      "_inferred": false
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "caveman-skill": {
      "command": "claude",
      "args": [
        "plugin",
        "marketplace",
        "add",
        "JuliusBrussee/caveman"
      ],
      "_inferred": false
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "caveman-skill": {
      "command": "claude",
      "args": [
        "plugin",
        "marketplace",
        "add",
        "JuliusBrussee/caveman"
      ],
      "_inferred": false
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "caveman-skill": {
      "command": "claude",
      "args": [
        "plugin",
        "marketplace",
        "add",
        "JuliusBrussee/caveman"
      ],
      "_inferred": false
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "caveman-skill",
      "command": "claude",
      "args": [
        "plugin",
        "marketplace",
        "add",
        "JuliusBrussee/caveman"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "caveman-skill": {
      "command": {
        "path": "claude",
        "args": [
          "plugin",
          "marketplace",
          "add",
          "JuliusBrussee/caveman"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add caveman-skill -- claude plugin marketplace add JuliusBrussee/caveman

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Caveman

Get crisp one-line commit messages for every patch

👤 Anyone tired of 8-paragraph AI-written commits ⏱ ~5 min beginner

Quando usar: Claude writes a commit message, and it's a novel. You want it to say 'fix: off-by-one in pagination' and stop.

Pré-requisitos

Caveman plugin installed — claude plugin marketplace add JuliusBrussee/caveman && claude plugin install caveman@caveman

Fluxo

Commit with caveman-commit

/caveman-commit — write a commit message for the staged changes.✓ Copiado

→ One-line conventional commit; no body unless genuinely needed
Ship a branch of small commits

For the 4 staged files, use /caveman-commit per file — atomic commits, one line each.✓ Copiado

→ git log shows 4 short commits

Resultado: Readable git log; bisect-friendly commits.

Armadilhas

Lost nuance when a message should be longer (e.g. breaking changes) — Override per-commit: 'write the full version, not caveman, this is a breaking change'

Combine com: git · github

Review a PR with one-line actionable comments

👤 Reviewers (and reviewees who dislike AI walls of text) ⏱ ~15 min beginner

Quando usar: You're doing a quick pass and want pointed nits, not lectures.

Fluxo

Run caveman-review

/caveman-review — go through the diff. One line per comment.✓ Copiado

→ Inline comments read like 'rename x → userId for consistency with api/users.ts'
Escalate when needed

On the auth file specifically, switch off caveman for a full-length security review.✓ Copiado

→ Long-form only where the stakes justify it

Resultado: Faster review cycles; reviewees don't dismiss comments as noise.

Armadilhas

One-liners miss nuance on architectural changes — Architectural changes aren't Caveman's job — use default mode for those

Combine com: github

Shrink CLAUDE.md and memory notes by 40–50% without losing intent

👤 Anyone whose CLAUDE.md grew past 5k tokens ⏱ ~10 min intermediate

Quando usar: Your project memory is eating context every session and you know it could be tighter.

Fluxo

Compress in place

/caveman-compress CLAUDE.md — keep rules and facts, cut the prose.✓ Copiado

→ File shrinks ~46%; no rule deleted
Audit the diff

Show the diff. Any rule that changed meaning?✓ Copiado

→ Per-change verdict; rollbacks if intent drifted
Commit

/caveman-commit — single-line commit for the compression✓ Copiado

→ 'chore: compress CLAUDE.md (-46%)'

Resultado: Same rules, half the tokens.

Armadilhas

Compression drops a subtle caveat — Always diff-review after compressing rule files; intent loss is the main risk

Combine com: filesystem

Combinações

Combine com outros MCPs para 10× de alavancagem

caveman-skill + git

Terse commit workflow

Stage the change, then /caveman-commit, then git push.✓ Copiado

caveman-skill + github

Caveman PR reviews at scale

For the 5 PRs in my review queue, /caveman-review each; post only actionable comments.✓ Copiado

caveman-skill + claude-mem-skill

Shrink memory transcripts without losing decisions

/caveman-compress the claude-mem notes for this project; flag anything where meaning shifted.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
/caveman	mode: Lite\|Full\|Ultra\|文言文	Toggle mode for the current task	free
/caveman-commit	staged diff (implicit)	At commit time; preserves staging	small model call
/caveman-review	PR diff	Quick review pass	small model call per file
/caveman-compress	file path	Shrink memory / rules files; diff-review before saving	small model call

Custo e limites

O que custa rodar

Cota de API: None
Tokens por chamada: By design — negative; saves tokens
Monetário: Free (MIT)
Dica: Use Ultra only on genuinely mechanical output (commits, tags); leave design discussions in default mode

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: None

Saída de dados: None — pure prompt shaping; no telemetry

Ultra mode can drop disclaimers and safety caveats. Don't use Ultra for legal, medical, or security advice output.

Solução de problemas

Erros comuns e correções

Output still verbose after enabling Caveman

Most clients run Caveman per-turn; put /caveman Full at the top of each session or add it to CLAUDE.md

Verificar: First reply should feel distinctly terse

Caveman-commit returns multi-paragraph body

Usually triggers when the diff is genuinely large or breaks API. For true one-liner, add '—force-oneline'.

Verificar: Re-run with --force-oneline

Classical Chinese mode outputs garbled

Rare; usually a font / terminal issue, not the skill. Pipe to a file and open in an editor that supports CJK.

Alternativas

Caveman vs. outros

Alternativa	Quando usar	Troca
System prompt with 'be terse'	You want it without a plugin	Inconsistent; Caveman's intensity levels + benchmarks give measurable results
Custom slash commands	You only need one of the sub-behaviors (e.g. terse commits)	Reinventing the wheel

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills