Download Latest Version v1.5.1 source code.tar.gz (108.6 kB)
Email in envelope

Get an email when there's a new version of caveman

Home / v1.5.0
Name Modified Size InfoDownloads / Week
Parent folder
README.md 2026-04-11 1.1 kB
v1.5.0 source code.tar.gz 2026-04-11 107.0 kB
v1.5.0 source code.zip 2026-04-11 163.5 kB
Totals: 3 Items   271.6 kB 0

Configurable default mode

Default mode is now configurable instead of always starting at full. Resolution order:

  1. CAVEMAN_DEFAULT_MODE environment variable (highest priority)
  2. Config file at ~/.config/caveman/config.json (XDG-compliant, cross-platform)
  3. 'full' (unchanged default — fully backward compatible)

    :::bash export CAVEMAN_DEFAULT_MODE=ultra

    :::json { "defaultMode": "lite" }

All install/uninstall scripts (bash + PowerShell) updated. Invalid modes silently fall through to default.

Closes [#86]

"off" mode — disable auto-activation

Set CAVEMAN_DEFAULT_MODE=off or {"defaultMode": "off"} in config to skip session-start activation entirely. No flag file written, no rules injected. User can still manually activate with /caveman during the session.

/caveman-help quick-reference card

New skill — type /caveman-help to display a terse reference card covering all modes, skills, triggers, configuration, and deactivation. One-shot display, no mode change.

Works in: Claude Code, Gemini CLI, Cursor, Windsurf, Cline, Copilot, and all agents via npx skills.

Source: README.md, updated 2026-04-11