Every Repowise setting (the .repowise/config.yaml keys, the two user-level
switches and the REPOWISE_* environment variables) is listed, explained and
changed through repowise config. Use it instead of reading or editing the
config files: it shows the value in effect and where it came from (default,
repository file, user file or environment), and set validates the value and
writes it where that setting lives.
When to use it
- The user asks what can be changed, or how to turn a feature on or off.
- The user asks about cost: tokens added to each session, model calls during an update, hooks that run on every tool call.
- Something behaves unexpectedly ("why does this hook fire", "why are these pages missing") and a setting may explain it.
- The user asks you to change a Repowise option.
Inspect
repowise config list --changed: what this repository changed from the defaults, with the source of each value. Start here when something behaves unexpectedly.repowise config list --area <area>: one area's settings and values. Areas: account, attribution, decisions, distill, editor, events, generation, health, hooks, indexing, mcp, providers, server. Plainrepowise config listshows them all by area.repowise config explain <key> --format json: what one setting does, what it accepts, its default, when a change takes effect (applies) and the exact commands to change and reset it (set_with,reset_with).
Add --format json to any of them to parse the result; list returns
{"repo", "settings": [...]} with key, description, value, source,
default and changed per setting. Prefer --area or --changed with JSON:
the full list is large.
Recommend
Read the descriptions of the settings in the relevant area against what you know about this repository (its size, languages, whether it has a model key, how the user works), and recommend a change only when it fits. Say what it does, what it costs or saves, and when it takes effect.
Change
- Ask the user first, naming the key, the new value and the effect. Never change a setting on your own initiative.
repowise config set <key> <value>. A switch takestrue/false, a list takesa,bor[a, b]. The text output is short;--format jsonrepeats the before and after state of every setting the change moved.- Relay the effect and the undo commands it prints. Some switches move
others with them (
decisions.moderesets the finer decision switches): name the settings that moved, not only the one you set. If it says an environment variable wins over the file (env_overridein JSON), tell the user that variable decides until it is unset.
repowise config reset <key> puts a setting back to its default. A refusal
exits 1 with {"error", "message", ...}: unknown_setting (the message
suggests near names), invalid_value (accepts says what fits), env_only
(the setting is an environment variable; tell the user where to set it) or
config_unreadable (the file is broken; nothing was written).
Never edit .repowise/config.yaml by hand: set validates the value and
keeps the rest of the file intact.