AgentToolHub
SkillClaude CodeCursorClineOpenClawWindsurfVS CodeChatGPT

caveman-stats

🪨 why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman

Features

  • ✓Reduces tokens by 75% in Claude Code
  • ✓One-line install for quick setup
  • ✓Introduces文言文 mode for concise commits
  • ✓Cuts input tokens by 46% with compression tool
  • ✓Enhances technical accuracy with minimal wordage

Installation Guide

One line. Detect every agent. Install for each.

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

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

Detects 30+ agents (Claude Code, Gemini CLI, Codex, Cursor, Windsurf, Cline, Copilot, Continue, Kilo, Roo, Augment, Aider Desk, Amp, Bob, Crush, Devin, Droid, ForgeCode, Goose, iFlow, JetBrains Junie, Kiro CLI, Mistral Vibe, OpenHands, opencode, Qwen Code, Qoder, Rovo Dev, Tabnine, Trae, Warp, Replit Agent, Antigravity, …). Runs each one's native install. Skips what you not have. Safe to re-run.

By default the installer wires Claude Code's hooks + statusline + stats badge and registers the [caveman-shrink](#caveman-shrink-mcp-middleware) MCP proxy on top of the plugin install. Pass --minimal to skip the extras and just install the plugin/extension. Pass --all to also drop per-repo rule files into the current directory.

| Flag | What |
|---|---|
| --all | Plugin + hooks + statusline + MCP shrink + per-repo rule files in $PWD. The full ride. |
| --minimal | Plugin/extension only. No hooks, no MCP shrink, no per-repo rules. |
| --dry-run | Preview, write nothing |
| --only <agent> | One target only (repeatable) |
| --with-hooks | Claude Code: also wire standalone hooks + statusline + stats badge. On by default. |
| --with-mcp-shrink | Claude Code: register the [caveman-shrink](#caveman-shrink-mcp-middleware) MCP proxy via npx caveman-shrink. On by default. |
| --with-init | Drop always-on rule files into the current repo (Cursor / Windsurf / Cline / Copilot / AGENTS.md). Off by default; turned on by --all. |
| --list | Print full agent matrix and exit |
| --force | Re-run even if already installed |

install.sh --help for full reference.

Manual install per agent:

| Agent | Command |
|---|---|
| Claude Code | claude plugin marketplace add JuliusBrussee/caveman && claude plugin install caveman@caveman |
| Gemini CLI | gemini extensions install https://github.com/JuliusBrussee/caveman |
| Cursor / Windsurf / Cline / Copilot | npx skills add JuliusBrussee/caveman -a <cursor\|windsurf\|cline\|github-copilot> |
| Codex / opencode / Roo / Amp / Goose / Kiro / Augment / Aider Desk / Continue / Kilo / Junie / Trae / Warp / Tabnine / Mistral / Qwen / Devin / Droid / ForgeCode / Bob / Crush / iFlow / OpenHands / Qoder / Rovo Dev / Replit / Antigravity | npx skills add JuliusBrussee/caveman -a <profile> (see install.sh --list for the full slug list) |
| Anything else (40+ agents) | npx skills add JuliusBrussee/caveman (auto-detect) |

Standalone Claude Code hooks (without plugin): bash <(curl -s https://raw.githubusercontent.com/JuliusBrussee/caveman/main/hooks/install.sh). Windows: irm https://raw.githubusercontent.com/JuliusBrussee/caveman/main/hooks/install.ps1 | iex. Manual fallback for stubborn Windows envs lives in [docs/install-windows.md](docs/install-windows.md).

Uninstall: disable the Claude plugin, gemini extensions uninstall caveman, or npx skills remove caveman.

What You Get

| Feature | Claude Code | Codex | Gemini CLI | Cursor / Windsurf | Cline / Copilot | Others* |
|---|:-:|:-:|:-:|:-:|:-:|:-:|
| Caveman mode | Y | Y | Y | Y | Y | Y |
| Auto-activate every session | Y | Y¹ | Y | with --with-init | with --with-init | with --with-init |
| /caveman command | Y | Y¹ | Y | — | — | — |
| Mode switching (lite/full/ultra) | Y | Y¹ | Y | Y² | — | — |
| Statusline badge | Y | — | — | — | — | — |
| caveman-commit / caveman-review | Y | — | Y | Y | Y | Y |
| caveman-compress / caveman-help | Y | Y³ | Y | Y | Y | Y |
| caveman-stats | Y | — | — | — | — | — |
| cavecrew (subagents) | Y | — | — | — | — | — |

\* opencode, Roo, Amp, Goose, Kiro CLI, Augment, Aider Desk, Continue, Kilo, Junie (JetBrains), Trae, Warp, Tabnine, Mistral, Qwen, Devin, Droid, ForgeCode, Bob, Crush, iFlow, OpenHands, Qoder, Rovo Dev, Replit, Antigravity, and more via npx skills. AGENTS.md / IDE rule files reach Zed, generic agents, etc. via --with-init.
¹ Codex uses $caveman instead of /caveman. Auto-start ships when you run Codex inside this repo (via .codex/hooks.json); for other repos, copy the hook or use $caveman manually. ² Mode switching is on-demand via the skill, no slash command. ³ Compress only.

--with-init writes .cursor/rules/caveman.mdc, .windsurf/rules/caveman.md, .clinerules/caveman.md, .github/copilot-instructions.md, and AGENTS.md into the current repo so caveman auto-starts there.

Reviews