@vanillagreen/pi-caveman
v1.0.5
Published
Native Pi caveman communication mode with session persistence, slash command control, status badge, and settings-manager integration.
Downloads
637
Maintainers
Readme
pi-caveman

Native Pi caveman communication mode: fewer output tokens, same technical accuracy.
Install
Via npm:
pi install npm:@vanillagreen/pi-cavemanVia vstack:
cargo install --git https://github.com/vanillagreencom/vstack.git vstack
vstack add vanillagreencom/vstack --pi-extension pi-caveman --harness pi -yRestart Pi after installation.
Commands
| Command | Action |
| --- | --- |
| /caveman | Toggle the current session between off and the last active mode. |
| /caveman:lite\|full\|ultra\|micro | Set a session override mode. |
| /caveman:toggle | Toggle the session override between off and the last active mode. |
| /caveman off | Disable caveman mode for the current session. |
| /caveman status | Show current mode and whether it comes from settings or a session override. |
Arguments support autocomplete.
Modes
| Mode | Style |
| --- | --- |
| lite | Professional full sentences, but no filler or hedging. |
| full | Classic terse caveman; fragments are OK. |
| ultra | Maximum English compression with abbreviations and arrows. |
| micro | Shortest prompt injection for token-sensitive sessions. |
Behavior
- The extension injects instructions in
before_agent_start; it does not post-process model output. - The canonical setting is
mode(off,lite,full,ultra, ormicro). Olderenabled+defaultModesettings are only read as a local fallback. /cavemancommands create a per-session override whensessionOverrideAllowedis on. Changing the extension-managermodesetting clears the session override so the configured mode takes over immediately.- Session override state and the last active mode persist in the Pi session and restore from the active branch.
- Settings live in Pi/vstack
settings.json; project settings override user settings. - QOL can use the caveman bridge for its compact statusline badge and
Alt+Ceditor shortcut. - The clarity/safety escape is prompt policy: destructive, security-sensitive, or ambiguous turns get explicit normal-clarity guidance while mode can remain active for later turns.
