caveman-plugin-dsh

Usage

/caveman (or /caveman help) opens a text wizard in the footer:

1on 2off 3st 4cav 5ultra 6mega · 7jev+ 8jev- 9key- 10ls 11url 12key+ q

Type the number; the footer repaints with the new state and nothing is sent to the model. q closes, any other text closes the menu and goes through as a normal message. Prompts (key, model pick) consume the next line and stay open on a bad value, showing the reason inline; c cancels the prompt. The menu expires after 120 s.

Pick	Action	Pick	Action
1	voice on	7	jev on
2	voice off	8	jev off
3	status	9	clear key
4 / 5 / 6	level caveman / ultracave / megacave	10	list models
10 / 11	provider typesafe / openrouter	12	set key

Direct verbs still work without the menu: /caveman on, /caveman off, /caveman status, /caveman caveman|ultracave|megacave, /caveman jev on|off| , /caveman key |clear, /caveman model [list|].

Spoken phrases work too and never need a slash: "stop caveman", "normal mode", "talk like caveman", "be brief". A loose phrase ("pode voltar ao modo normal?") is disambiguated by the decision model before it is acted on.

Every change is persisted to the state file, so the mode, level and jev switch survive a restart.

Configuration

Optional keys in the profile row's config:

Key	Default	Meaning
alwaysOn	true	initial voice mode when the file is first created
decision.timeoutMs	1500	hard cap per classification
decision.apiKey	–	inline OpenRouter key for CI, wins over the file
commands	true	register the /caveman command
status	true	show the TUI badge

- id: caveman-plugin-dsh
  config:
    alwaysOn: false

CAVE_DEBUG=1 appends scope/classify decisions to $TMPDIR/caveman-plugin-dsh.log.