repowiserepowise

Command-line tool

juliusbrussee / caveman

why use many token when few token do trick. Skill + local proxy for coding agents: shorter answers, smaller tool output, every original recoverable.

★ 122,044stars on GitHubGoApache-2.0

This connects Repowise to juliusbrussee/caveman's code. It does not install caveman.

Repowise maps public repos from their source. Not affiliated with juliusbrussee. What is Repowise?

github.com/juliusbrussee/cavemanIndexed at a192894

What is caveman?

caveman is a set of tools that runs on your machine to cut the tokens an AI coding agent sends to models and reads back, so the same work costs less. It pairs a skill that makes the agent's answers shorter with a local proxy that shrinks tool output, and every original stays recoverable. The main language is Go, and the repository also includes JavaScript, Python and TypeScript code. To install it, run npx @caveman-ai/cli@latest and follow the steps below. Its code health is 6.3 out of 10 (Fair), ranked #195 of 4,000+ indexed repos. The last commit to caveman was on Nov 17, 2026, and 122 people have contributed.

As of commit a192894, indexed Nov 21, 2026. What it is comes from a model reading the README; the rest is measured from the source and git history, not from the maintainer.

For agentscaveman.md

Repo facts: type, license, health, rank, contributors
caveman facts
TypeCommand-line tool
LicenseApache-2.0
Code health6.3 / 10 (Fair)
Health rank#195 of 4,000+ indexed repos
Last commitNov 17, 2026
Contributors122
Bus factor1
Size1,610 files, 288,143 lines

Install caveman

Commands copied from the README

  1. 1Install caveman, which finds your agents and logins and shows what it changes before you press Enter. Needs Node.js 22.13+.
    npx @caveman-ai/cli@latest
  2. 2Install only the skill, with no proxy.
    npx skills add JuliusBrussee/caveman -g

Releases on GitHub (latest v4.1.0, Nov 8, 2026)

Full install notes on GitHub

Explore caveman

Ask about this code in your agent

This connects Repowise to caveman's code. It does not install caveman. To install caveman, use the install steps.

Useful if you want to change or fork caveman: your agent can ask how it is put together and get answers that cite its files.

Ask about caveman

Answers come from caveman's README and source, with the files they cite. Two free answers a day without an account.

Featured answer

caveman is a set of tools that runs on your machine to cut the tokens an AI coding agent sends to models and reads back, pairing a skill that shortens answers with a local proxy that shrinks tool output while keeping every original recoverable. The main language is Go, though the repository also includes JavaScript, Python and TypeScript code across 1610 files. Agent traffic passes through the proxy module, the largest module with 412 files, whose gateway code in proxy/internal/gateway, including route.go and proxy.go, is a hotspot. The engine started from engine/cmd/caveman-engine/main.go shrinks logs, JSON and code while keeping originals locally, and the browse directory lets an MCP client drive a local Chrome through browse/bin/caveman-browse.mjs. By file count, the layers are Application with 383 files, Docs & Tooling with 104, Service with 91, Middleware with 69, Data with 46, CLI with 53, Utility with 37, Types with 39 and Config with 33. To start reading, open the proxy gateway files, engine/cmd/caveman-engine/main.go, and packages/cli/src/index.ts, which is the command-line hotspot.

Files per layer in caveman9 layers.

Basis: Inferred · knowledge graph· as of a192894

Want this for your own codebase? Map your repo free

About this page

Get a page like this for your own codebase

Repowise built this map of juliusbrussee/caveman from its source and git history. It parses every symbol, draws the dependency graph, scores each file's health from complexity, duplication, coverage and churn, finds hotspots and owners in the history, and writes documentation for every module. Your coding agent reads the same index over MCP, so its answers cite real files.

Free for 2 public repos, with a page like this one. No card. See how Repowise works

Prefer local? pip install repowise && repowise init indexes your own checkout, no account needed. Star Repowise on GitHub

juliusbrussee/caveman FAQ

What is caveman?

caveman is a set of tools that cuts the tokens an AI coding agent sends to models and reads back, running on your machine. It combines a skill that shortens agent answers with a local proxy that shrinks tool output. Original content stays recoverable.

How does caveman work?

caveman routes agent traffic through a local proxy, where the engine shrinks logs, JSON and code before a model reads them. The engine keeps the original bytes locally so the agent can fetch them later. A skill keeps the agent's own answers short while code and commands stay exact.

What language is caveman written in?

caveman is written mainly in Go. The repository also contains JavaScript, Python, TypeScript and shell code.

How is the caveman code organized?

The proxy directory holds the local proxy and is the largest module, and engine holds the code that shrinks content. browse lets an agent read web pages in a local Chrome, and packages holds the command-line code. Entry points include engine/cmd/caveman-engine/main.go.

Who is caveman for?

caveman is for developers on Mac, Linux or Windows who use coding agents such as Claude Code, Codex and Gemini CLI. It wraps those agents to cut the tokens they send and read back.

What license does caveman use?

caveman uses the Apache-2.0 license.

Code health

6.3out of 10Fair

Hotspots average 4.5, the place fixes pay off most.

On the leaderboards:#23 of 28 Go repos

Key features of caveman

  • Shrinks logs, JSON, CSV and test output before the model reads them.
  • Keeps the agent's answers short while code, commands, paths and error messages stay exact.
  • Runs a code mode where the agent keeps the scripts it writes and runs them again.
  • Returns web pages from the browse tool in compressed form.
  • Picks the model and the effort level for each ask with Auto, which needs a free account.

How juliusbrussee/caveman works

Traffic from a coding agent goes through the proxy module, the largest module with 412 files. The gateway code in proxy/internal/gateway, including route.go and proxy.go, is listed as a hotspot file. The engine module, started through engine/cmd/caveman-engine/main.go, shrinks logs, JSON and code that the agent sends to a model, and it keeps the original bytes locally so the agent can fetch them later. The browse directory lets an agent read and act on web pages in a local Chrome, and an MCP client starts that server through browse/bin/caveman-browse.mjs before calling its browser tools. The .codex/codex-sessionstart.js hook runs when a Codex session starts, and packages/cli/src/index.ts, a hotspot file, belongs to the command-line package.

The codebase has 1,610 files and 16,626 symbols in 24 modules, led by Go, JavaScript and Python. Code health is 6.3 out of 10, rated fair.