Enum ConfigCommand 

pub enum ConfigCommand {
    Show {
        global: bool,
        project: bool,
        show_secrets: bool,
    },
    Set {
        path: String,
        value: String,
        global: bool,
    },
    Unset {
        path: String,
        global: bool,
    },
    Role {
        role: String,
        model: String,
        effort: Option<String>,
    },
}

Subcommands under kranz config — the configuration surface.

Variants

Show

Print the effective merged config (defaults <- global <- project).

The merged layer files (and whether each exists) are listed on stderr, so stdout stays clean JSON for piping. –global / –project print just that one layer file instead (“{}” plus a stderr note when missing).

Single-layer output is REDACTED: the raw layer file carries keys MissionConfig never sees (slack.botToken, slack.appToken, hooks.secret), and stdout ends up in CI logs, screen shares and shell transcripts. --show-secrets prints them verbatim.

Fields

global: bool

Print only ~/.kranz/config.json (the global layer)

project: bool

Print only <repo>/.kranz/config.json (the project layer)

show_secrets: bool

Print secret-shaped values verbatim instead of [REDACTED]

Set

Set one key in a config layer file (validated before writing).

PATH is a dotted path into the config (worker.model, orchestrator.reasoningEffort, maxParallelWorkers, skipScrutiny, …). VALUE parses as JSON first (2, true, [“x”]) and falls back to a plain string, so kranz config set worker.model opus works unquoted. Only that key changes — every other key in the file (known or not) is preserved. The merged result of all layers is validated first; on failure nothing is written.

Fields

path: String

Dotted path into the config (e.g. worker.model)

value: String

The value (JSON if it parses, plain string otherwise)

global: bool

Write to ~/.kranz/config.json instead of <repo>/.kranz/config.json

Unset

Remove one key from a config layer file.

Parent objects left empty by the removal are pruned; removing the last key leaves an empty “{}” file (the file itself is never deleted).

Fields

path: String

Dotted path into the config (e.g. worker.model)

global: bool

Edit ~/.kranz/config.json instead of <repo>/.kranz/config.json

Role

Change a role’s model/effort on a RUNNING mission (mid-mission path).

Enqueues a config-change control command on the target mission’s control inbox — the CLI twin of Slack’s /kranz config. The target is the global –mission id (which must be active), or, without one, the repo’s single active mission; with several active this refuses and lists them. The change applies at the next spawn of that role; the layer files are not touched.

Fields

role: String

orchestrator | worker | scrutiny | functional

model: String

Model alias or full id passed to claude --model (e.g. opus)

effort: Option<String>

low | medium | high | xhigh | max (unchanged when omitted)

Trait Implementations

impl Debug for ConfigCommand

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FromArgMatches for ConfigCommand

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut<'b>( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Subcommand for ConfigCommand

fn augment_subcommands<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_subcommands_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

fn has_subcommand(__clap_name: &str) -> bool

Test whether Self can parse a specific subcommand