- Add configurable default caveman mode via CAVEMAN_DEFAULT_MODE environment variable or ~/.config/caveman/config.json with fallback to 'full'
- Add /caveman-help skill to display a quick-reference card covering all modes, skills, triggers, configuration, and deactivation
- Fix Codex plugin compress skill on Windows by replacing symlinks with real file copies and adding CI sync step for future propagation
Fix: Codex plugin compress skill broken on Windows
The compress skill in the Codex plugin shipped as symlinks (plugins/caveman/skills/compress/SKILL.md and scripts). On Windows and any git setup with core.symlinks=false, these checked out as plain text files containing the target path — causing Codex to reject the skill with "missing YAML frontmatter."
Changes
- Replaced symlinks with real file copies (scripts identical to source, SKILL.md adapted for plugin context)
- Added CI sync step so future edits to
caveman-compress/auto-propagate to the plugin copy
Closes #92
Feature: Configurable default caveman mode
Default mode is now configurable instead of always starting at full. Resolution order:
CAVEMAN_DEFAULT_MODEenvironment variable (highest priority)- Config file at
~/.config/caveman/config.json(XDG-compliant, cross-platform) 'full'(unchanged default — fully backward compatible)
Example — env var:
export CAVEMAN_DEFAULT_MODE=ultra
Example — config file:
{ "defaultMode": "lite" }
All install/uninstall scripts (bash + PowerShell) updated. Invalid modes silently fall through to default.
Closes #86
Feature: /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.