woz-settings

name: woz-settings description: Manage WOZCODE plugin settings - toggle attribution, status line, spinner verbs. allowed-tools: Bash(node *)

WOZCODE Settings

Manage WOZCODE plugin settings. The user-facing knobs (attribution, status line, spinner verbs, the live-reviewer toggles, …) live in ~/.claude/settings.json under the wozcode key. Prefer the --show / --set helper below over hand-editing — it applies the right side effects.

TRIGGER when: user says "woz settings", "woz config", "configure woz", "toggle attribution", "turn off status line", "disable co-authored-by", or similar.

Usage

Run the settings helper to show or update settings:

Show current settings

node --no-warnings=ExperimentalWarning ${CLAUDE_PLUGIN_ROOT}/scripts/settings-helper.js --show

Display the JSON output as a readable table for the user.

Update a setting

node --no-warnings=ExperimentalWarning ${CLAUDE_PLUGIN_ROOT}/scripts/settings-helper.js --set <key> <value>

Where <key> is a setting name and <value> is true or false.

Available settings:

Key	Default	Description
`attribution`	`true`	Co-Authored-By on commits + PR badge
`statusLine`	`true`	Master toggle for the WOZCODE status line
`statusLineSession`	`true`	Show session savings in status line
`statusLineLifetime`	`true`	Show lifetime savings in status line
`statusLineTips`	`true`	Show quick tips in status line
`statusLineShare`	`true`	Show /woz-share referral hint in status line
`spinnerVerbs`	`true`	WOZ-themed spinner verbs
`alwaysLoadTools`	`true`	Load WOZCODE MCP tools up-front instead of deferring them behind ToolSearch
`recall`	`true`	Session recall: the `Recall` MCP tool, the `/woz-recall` skill, and the background session indexer. Takes effect immediately.
`liveReviewer`	`false`	Live PostToolUse reviewer (runs on every Edit)
`liveReviewerModel`	(live-pass default)	Model id for the live pass. Unknown ids fall back to the default.
`deepEditCountReviewer`	`false`	Every-N-edits deep-pass cadence trigger
`deepEditCountInterval`	`50`	Edits between deep cadence triggers (clamped to [5, 1000])
`wozReviewModel`	`''` (current model)	Pinned model for `/woz-review` and the every-N-edits cadence. Empty = your current/SDK-default model; set a model id to pin it. Accepts `provider/model` syntax to auto-route through the WOZCODE router — requires `wozcode router start`.
`userEnabled`	`true`	Master plugin on/off. When `false`, pins `settings.agent` to `woz:code-free` (native Claude tools available, WOZCODE MCP disallowed). Same toggle as the desktop tray's "WOZCODE plugin: ON/OFF".
`showInMenuBar`	`true`	Whether the macOS menu-bar tray launches at login. Setting to `true` from the CLI re-launches the tray immediately. Setting to `false` unregisters the LaunchAgent; the running tray keeps going until quit.

Runtime-gated on KB access: the live-reviewer knobs (liveReviewer, liveReviewerModel, deepEditCountReviewer, deepEditCountInterval, wozReviewModel) ship in every build but are gated on the org's KnowledgeBase-access entitlement at runtime — --show omits them and --set rejects them when the org isn't entitled. Treat the --show output as authoritative and don't offer to set a key it doesn't list.

The KnowledgeBase backend settings (knowledgeBaseProvider, knowledgeBaseServerUrl) and reviewerBaseUrl are internal/infra and are not surfaced by --show for now.

About `alwaysLoadTools`

Claude Code can either load an MCP server's tool schemas into every session up-front, or defer them — in which case the model has to call the built-in ToolSearch tool once before it can use them.

true (default): WOZCODE's tools (Search, Edit, Sql, Recall, Bash) are available immediately on every session. Best UX — the model uses them on the first turn without an extra discovery step.
false: Tool schemas are deferred. Saves a small amount of system-prompt tokens per session, useful if you start lots of short sessions where you don't end up using WOZCODE's tools. The model will call ToolSearch to load them on first use.

Only affects WOZCODE's MCP server (code). Other MCP servers in your config are not touched.

Changes to this setting take effect on the next Claude Code launch because .mcp.json is read at startup, before session hooks run.

Examples:

# Disable attribution
node --no-warnings=ExperimentalWarning ${CLAUDE_PLUGIN_ROOT}/scripts/settings-helper.js --set attribution false

# Turn off status line tips
node --no-warnings=ExperimentalWarning ${CLAUDE_PLUGIN_ROOT}/scripts/settings-helper.js --set statusLineTips false

# Disable spinner verbs
node --no-warnings=ExperimentalWarning ${CLAUDE_PLUGIN_ROOT}/scripts/settings-helper.js --set spinnerVerbs false

# Defer WOZCODE tools behind ToolSearch (requires restart)
node --no-warnings=ExperimentalWarning ${CLAUDE_PLUGIN_ROOT}/scripts/settings-helper.js --set alwaysLoadTools false

After updating settings, tell the user:

Most changes take effect immediately
For statusLine, attribution, and spinnerVerbs: also tell them to run /reload-plugins so Claude Code picks up the change in the current session
For alwaysLoadTools: tell them to restart Claude Code for the change to take effect (the helper already prints this reminder)
For recall: takes effect immediately; the first Recall after enabling kicks off background indexing (no restart needed)