# juliusbrussee/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.

Source: https://github.com/juliusbrussee/caveman
Indexed: commit a192894 on 2026-11-21 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: Command-line tool
- Language: Go
- Stars: 122,071 at index time
- License: Apache-2.0
- Code health: 6.3/10, Fair
- Last commit: 2026-11-17
- Contributors: 122

## Install

From the README: https://github.com/juliusbrussee/caveman#install

Install 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

Install only the skill, with no proxy.
    npx skills add JuliusBrussee/caveman -g

## How it 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.

- benchmarks/run.py: entry point
- browse/bin/caveman-browse.mjs: entry point
- browse/cmd/caveman-browse/main.go: entry point
- engine/cmd/caveman-engine/main.go: entry point
- engine/cmd/caveman-wasm/main.go: entry point
Modules: proxy, packages, engine, tests, shared, browse, extension, src. 1,610 files, 288,143 lines, 16,626 symbols.

## Code health

- Score: 6.3/10 (Fair)
- Trend: 6.3 on 2026-11-16, 6.3 on 2026-11-21
- Rank: #195 of 4,000+ indexed repos
- Hotspots: packages/cli/src/index.ts, installer/install.js, proxy/internal/gateway/route.go, proxy/internal/cloudlink/link.go, proxy/internal/gateway/proxy.go
- Lowest file: packages/cli/src/index.ts
- Dead code: 17 findings

## Maintenance

- Last commit 2026-11-17, first commit 2026-04-04, 1,782 commits
- 122 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/juliusbrussee/caveman/security

## More

- Page: https://repowise.dev/repo/juliusbrussee/caveman
- Ask this codebase: https://repowise.dev/repo/juliusbrussee/caveman/chat
- Docs: https://repowise.dev/repo/juliusbrussee/caveman/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/juliusbrussee/caveman
