caveman Files

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:

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)

Example — env var:

:::bash
export CAVEMAN_DEFAULT_MODE=ultra

Example — config file:

:::json
{ "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.