Caveman 3.0.0

Everything is Apache-2.0 now

The whole repo, including engine, proxy, browse, MCP server, shrink, the cavemem Go core and shared platform, is licensed Apache-2.0 from 3.0.0 onward. There's no hosted-service restriction and no Change Date, and you don't need a commercial license. Fork it, embed it, run it for your company. LICENSING.md has the details.

Earlier releases keep the license they shipped with. Code that outside contributors wrote under MIT stays available under MIT (LICENSE-MIT).

Caveman Learn runs itself

• Autopilot. After a session ends, Learn re-checks your history in the background at low priority, at most every 6 hours. It never makes a session wait, and caveman learn autopilot off stops it.
• Memory doctor. It finds MEMORY.md notes Claude Code never loads (Claude Code only reads the first 200 lines or 25KB), @imports pointing at missing files, the same rule loaded from two files, and stale paths in CLAUDE.md.
• Trends. Week-over-week numbers from your own sessions. They use the median session, and you get "not enough data" when there are fewer than 5 sessions.
• Built-in model price list, now including the current Claude and GPT lineups. Numbers no longer depend on which folder you run from.
• Every fix still asks first, gets re-counted, and is undone if it didn't make each message smaller.

Middleware 1.0 and SDK 1.2

• @caveman-ai/middleware and caveman-middleware are stable at 1.0.0 and need SDK 1.2.0.
• Adapters fail open: if Caveman has a problem, your request goes through untouched and you get a loud warning.
• The proxy adds tenant identity, a Postgres HA store, TLS/mTLS and HA deploy manifests (deploy/).
• @caveman-ai/contracts 2.0.0 publishes the protocol 1.1 schemas and OpenAPI.

Telemetry

The CLI and its agent hooks send usage stats with a random install ID and your IP address. This is on by default. Turn it off with caveman telemetry off or DO_NOT_TRACK=1, and CI never sends. The skill by itself sends nothing. See SECURITY.md.

Versions

Upgrade

npx -y github:JuliusBrussee/caveman

Breaking: the SDK license changes from MIT to Apache-2.0, and middleware 1.0.0 requires SDK >= 1.2.0.