argsbarg 5.0.3 → 5.1.0

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [5.1.0] - 2026-07-04
+
+### Changed
+
+- **Breaking: `config get`/`set` → `configure get`/`set`** — top-level `config` removed; app config introspection lives under the `configure` built-in.
+
 ## [5.0.3] - 2026-07-04
 
 ### Changed
@@ -579,7 +585,8 @@ const cli = { ... } satisfies CliProgram;  // or : CliProgram
 - Migrate schemas: rename every `children` property to **`commands`**; move positional definitions to **`CliPositional`** objects on `positionals` and strip `positional` / `argMin` / `argMax` from flag definitions under `options` (flags only carry `name`, `description`, `kind`, and optional `shortName`).
 - Imports: use `CliPositional` where needed; replace `CliOptionDef` with `CliOption` or `CliPositional` as appropriate.
 
-[Unreleased]: https://github.com/bdombro/bun-argsbarg/compare/v5.0.3...HEAD
+[Unreleased]: https://github.com/bdombro/bun-argsbarg/compare/v5.1.0...HEAD
+[5.1.0]: https://github.com/bdombro/bun-argsbarg/releases/tag/v5.1.0
 [5.0.3]: https://github.com/bdombro/bun-argsbarg/releases/tag/v5.0.3
 [5.0.2]: https://github.com/bdombro/bun-argsbarg/releases/tag/v5.0.2
 [5.0.1]: https://github.com/bdombro/bun-argsbarg/releases/tag/v5.0.1

package/docs/cli-program.md

@@ -412,11 +412,11 @@ await cli.run();
 
 | Field | Default | Purpose |
 | --- | --- | --- |
-| `description` | *(required)* | Shown in prompts, `config get`, and bundle manifests |
+| `description` | *(required)* | Shown in prompts, `configure get`, and bundle manifests |
 | `title` | config key | Short label in interactive `configure` |
 | `default` | — | Used when `jsonSchema` omitted (all-string mode) |
 | `required` | `true` | When `false`, optional unless required by `jsonSchema` |
-| `sensitive` | name heuristic (`token`, `secret`, …) | Redact in prompts, `config get`, and status |
+| `sensitive` | name heuristic (`token`, `secret`, …) | Redact in prompts, `configure get`, and status |
 | `env` | — | When set: non-empty host env overrides file; consulted again after `resolve` when `resolve` returns `undefined`; exported to `process.env` after resolve |
 | `resolve` | — | Optional fallback after file; return `undefined` to fall back to `env` (if set) and defaults |
 
@@ -425,7 +425,7 @@ await cli.run();
 - Default: `$XDG_CONFIG_HOME/<sanitized-key>/config` or `%APPDATA%/<key>/config`.
 - JSON: flat object keyed by schema names — `{ "apiToken": "…", "maxRetries": 5 }`.
 - **Strict:** unknown keys rejected on load.
-- **CLI:** missing required config exits 1 before the leaf handler (TTY prompt when interactive). Built-in `docs` and `config get`/`set` skip this exit.
+- **CLI:** missing required config exits 1 before the leaf handler (TTY prompt when interactive). Built-in `docs` and `configure get`/`set` skip this exit.
 - **MCP:** server stays up; missing config returns `isError: true` at `tools/call`.
 - **Configure:** interactive `configure` runs the app config wizard; **`configure --sync`** refreshes agent artifacts.
 - **Agent integration:** `configure.agentIntegration` (`mcp` | `skill` | `both`) sets default sync targets; see [configure.md](configure.md#configuretargets).
@@ -436,7 +436,7 @@ See [config-schema.md](config-schema.md) for codegen, [configure.md](configure.m
 
 ## Reserved names
 
-Do not declare user commands named `completion`, `configure`, `mcp`, `version`, `docs`, or `config` at the root — ArgsBarg injects these when configured.
+Do not declare user commands named `completion`, `configure`, `mcp`, `version`, or `docs` at the root — ArgsBarg injects these when configured. App config uses `configure get` / `configure set` subcommands (not a top-level `config` command).
 
 ## Cursor rule for consumer repos
 

package/docs/config-schema.md

@@ -40,7 +40,7 @@ await cli.run();
 | --- | --- |
 | Config file | Flat JSON keyed by schema names; strict load (unknown keys rejected) |
 | Interactive `configure` / `--status` | Auto-runs config wizard when `entries` is non-empty; `--status` for read-only inventory |
-| Built-in `config get` / `config set` | Read/write resolved values (opt-out via `commands: false`) |
+| Built-in `configure get` / `configure set` | Read/write resolved values (opt-out via `commands: false`) |
 | MCP bundle / Claude plugin | `userConfig` for entries with `env` set |
 | `ctx.appConfig` in handlers | `get`, `require`, `set`, `read`, `path`, `dir` — prefer over `process.env` |
 
@@ -48,7 +48,7 @@ await cli.run();
 
 **No public config I/O exports** — consumers use `program.appConfig` for authoring and `ctx.appConfig` in handlers.
 
-See [cli-program.md — Configuration](cli-program.md#configuration-programappconfig) for resolution order, bootstrap timing, and reserved `config` command.
+See [cli-program.md — Configuration](cli-program.md#configuration-programappconfig) for resolution order, bootstrap timing, and `configure get`/`set`.
 
 ## `CliAppConfig` and `CliAppConfigEntry`
 
@@ -191,26 +191,26 @@ appConfig: {
 
 All file values are strings. Defaults come from `entry.default`.
 
-## Built-in `config` command
+## Built-in `configure get` / `configure set`
 
 When `program.appConfig` is set and `commands !== false`:
 
 | Subcommand | Purpose |
 | --- | --- |
-| `config get [key]` | Resolved value(s); `--json`; `--json --pretty` |
-| `config set <key> <value>` | One key; full document re-validated after merge |
+| `configure get [key]` | Resolved value(s); `--json`; `--json --pretty` |
+| `configure set <key> <value>` | One key; full document re-validated after merge |
 
-`config get`/`set` skip required-config exit and TTY prompts. Sensitive values redact on `get` (`REDACTED` / `{ "set": true }` with `--json`).
+`configure get`/`set` skip required-config exit and TTY prompts. Sensitive values redact on `get` (`REDACTED` / `{ "set": true }` with `--json`).
 
-Object/array/`$ref` properties require `--json` on `config set`.
+Object/array/`$ref` properties require `--json` on `configure set`.
 
 ## Example in this repo
 
 | Example | Role |
 | --- | --- |
-| [`examples/full-example/`](../examples/full-example/) | **Copy template** — schemagen discovery, `APP_CONFIG_JSON_SCHEMA` bridge, `program.appConfig`, built-in `config get`/`set` |
+| [`examples/full-example/`](../examples/full-example/) | **Copy template** — schemagen discovery, `APP_CONFIG_JSON_SCHEMA` bridge, `program.appConfig`, built-in `configure get`/`set` |
 
 ```bash
 cd examples/full-example && just setup && just schemagen
-FULL_EXAMPLE_API_TOKEN=dev just run config get apiToken --json
+FULL_EXAMPLE_API_TOKEN=dev just run configure get apiToken --json
 ```

package/docs/configure.md

@@ -47,6 +47,10 @@ Dev flow matches release: formula `install` copies the binary and generates comp
 
 # Remove app config only (not skills/MCP)
 <key> configure --remove-config --yes
+
+# Read or write app config (non-interactive; when program.appConfig is set)
+<key> configure get [key] [--json] [--pretty]
+<key> configure set <key> <value> [--json]
 ```
 
 Non-interactive / CI: pass **`--yes`** (or **`--json`**, **`--sync`**, **`--remove-all`**, **`--remove-config`**) — see [Confirmation](#confirmation).

package/docs/mcp.md

@@ -327,7 +327,7 @@ At server start (`Cli.serveMcp()`), before the NDJSON loop:
 - Loaded at MCP startup; host `process.env` wins for mapped env vars already set.
 - Missing required config does **not** exit the MCP server — enforced at `tools/call` with a helpful error.
 - Configure interactively: `myapp configure` (see [configure.md](configure.md)).
-- Built-in `config get` / `config set` when `program.appConfig.commands` is enabled (default). Hosts inject `user_config` → env at spawn; they never write the argsbarg config file.
+- Built-in `configure get` / `configure set` when `program.appConfig.commands` is enabled (default). Hosts inject `user_config` → env at spawn; they never write the argsbarg config file.
 
 Example:
 

package/examples/full-example/README.md

@@ -6,7 +6,7 @@
 
 | Area | Files / wiring |
 | --- | --- |
-| All builtins | `completion`, `version`, `install`, `docs`, `mcp`, `config get`/`set` |
+| All builtins | `completion`, `version`, `configure`, `docs`, `mcp`, `configure get`/`set` |
 | `program.appConfig` | `src/types.ts` (`AppConfig`) → `schemas/configSchemas.ts` |
 | `outputSchema` | `src/commands/status/types.ts` (`StatusJsonOutput`) → `schemas/outputSchemas.ts` |
 | Schemagen | `scripts/schemagen.ts` + `scripts/schemagen/discover-schema-roots.ts` |
@@ -47,7 +47,7 @@ cd examples/full-example
 just setup
 just schemagen   # after changing src/**/types.ts
 FULL_EXAMPLE_API_TOKEN=dev just run status --json
-FULL_EXAMPLE_API_TOKEN=dev just run config get apiToken --json
+FULL_EXAMPLE_API_TOKEN=dev just run configure get apiToken --json
 FULL_EXAMPLE_API_TOKEN=dev just run docs readme
 ```
 

package/examples/full-example/src/program.ts

@@ -50,8 +50,5 @@ export const program = {
     mcpd: true,
     claudePlugin: true,
   },
-  configure: {
-    // Defaults: agentIntegration picks skill vs MCP for sync; app config is opt-in in interactive configure.
-  },
   commands: [echoCommand, statusCommand],
 } satisfies CliProgram;

package/index.d.ts

@@ -281,7 +281,7 @@ export interface CliAppConfigEntry {
 	/** When `false`, optional for bootstrap and MCP enforcement. Default: `true`. */
 	required?: boolean;
 	/**
-	 * Mask stdin during prompts and redact on `config get`.
+	 * Mask stdin during prompts and redact on `configure get`.
 	 * Default: `/key|token|secret|password/i.test(name)`.
 	 */
 	sensitive?: boolean;
@@ -297,7 +297,7 @@ export interface CliAppConfigEntry {
  * App configuration block on the program root ({@link CliProgram.appConfig}).
  */
 export interface CliAppConfig {
-	/** Built-in `config get` / `config set`. Default: enabled when `appConfig` is set. */
+	/** Built-in `configure get` / `configure set`. Default: enabled when `appConfig` is set. */
 	commands?: boolean | {
 		enabled?: boolean;
 		mcpSet?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "argsbarg",
-  "version": "5.0.3",
+  "version": "5.1.0",
   "type": "module",
   "engines": {
     "bun": ">=1.3"

package/src/builtins/builtins.test.ts

@@ -154,8 +154,8 @@ describe("completion emitters", () => {
 
 /** Tests for schema export builtins. */
 describe("schema export builtins", () => {
-  /** ExportPresentationBuiltins includes config when appConfig set. */
-  test("exportPresentationBuiltins includes config when appConfig set", () => {
+  /** ExportPresentationBuiltins nests configure get/set when appConfig set. */
+  test("exportPresentationBuiltins nests configure get/set when appConfig set", () => {
     const withConfig: CliProgram = {
       ...fixture,
       appConfig: {
@@ -165,8 +165,14 @@ describe("schema export builtins", () => {
       },
     };
     const builtins = exportPresentationBuiltins(withConfig);
-    expect(builtins.map((b) => b.key)).toContain("config");
     expect(builtins.map((b) => b.key)).toContain("configure");
+    expect(builtins.map((b) => b.key)).not.toContain("config");
+    const configureNode = builtins.find((b) => b.key === "configure");
+    expect(configureNode && "commands" in configureNode).toBe(true);
+    if (configureNode && "commands" in configureNode) {
+      const keys = configureNode.commands?.map((c) => c.key) ?? [];
+      expect(keys).toEqual(expect.arrayContaining(["get", "set"]));
+    }
   });
 
   test("exportPresentationBuiltins omits hidden completion", () => {

package/src/builtins/config.test.ts

@@ -38,7 +38,7 @@ describe("builtins/config", () => {
       const configPath = resolveAppConfigPath(program);
       mkdirSync(dirname(configPath), { recursive: true });
       writeFileSync(configPath, `${JSON.stringify({ apiToken: "secret" })}\n`);
-      const result = await new Cli(program).invoke(["config", "get", "apiToken"]);
+      const result = await new Cli(program).invoke(["configure", "get", "apiToken"]);
       expect(result.exitCode).toBe(0);
       expect(result.stdout.trim()).toBe("REDACTED");
     } finally {
@@ -61,7 +61,7 @@ describe("builtins/config", () => {
       const configPath = resolveAppConfigPath(program);
       mkdirSync(dirname(configPath), { recursive: true });
       writeFileSync(configPath, `${JSON.stringify({ apiToken: "secret" })}\n`);
-      const result = await new Cli(program).invoke(["config", "get", "apiToken", "--json"]);
+      const result = await new Cli(program).invoke(["configure", "get", "apiToken", "--json"]);
       expect(result.exitCode).toBe(0);
       expect(JSON.parse(result.stdout)).toEqual({ set: true });
     } finally {
@@ -82,9 +82,9 @@ describe("builtins/config", () => {
     try {
       const program = configFixture();
       writeAppConfigFile(program, { apiToken: "seed" });
-      const result = await new Cli(program).invoke(["config", "set", "port", "9090"]);
+      const result = await new Cli(program).invoke(["configure", "set", "port", "9090"]);
       expect(result.exitCode).toBe(0);
-      const get = await new Cli(program).invoke(["config", "get", "port"]);
+      const get = await new Cli(program).invoke(["configure", "get", "port"]);
       expect(get.stdout.trim()).toBe("9090");
     } finally {
       if (prevHome === undefined) delete process.env.HOME;

package/src/builtins/config.ts

@@ -1,14 +1,19 @@
 /*
-Built-in `config get` / `config set` commands.
+Built-in `configure get` / `configure set` subcommands.
 */
 
 import { bootstrapAppConfig } from "../config/bootstrap.ts";
-import { configEntrySensitive, defaultConfigEntryTitle } from "../config/entry.ts";
+import {
+  configCommandsEnabled,
+  configEntrySensitive,
+  configMcpSetEnabled,
+  defaultConfigEntryTitle,
+} from "../config/entry.ts";
 import { writeAppConfigFile } from "../config/file.ts";
 import { captureMappedHostEnv, exportConfigToEnv, resolveAppConfig } from "../config/resolve.ts";
 import { configPropertySchema, effectiveJsonSchema } from "../config/schema.ts";
 import { parseConfigSetValue } from "../config/validate.ts";
-import type { CliLeaf, CliOption, CliProgram, CliRouter } from "../types.ts";
+import type { CliLeaf, CliOption, CliProgram } from "../types.ts";
 import { CliOptionKind } from "../types.ts";
 
 const JSON_OPTION: CliOption = {
@@ -182,16 +187,16 @@ function configSetLeaf(program: CliProgram, mcpSetEnabled: boolean): CliLeaf {
     handler: (ctx) => {
       const key = ctx.args[0];
       if (!key) {
-        process.stderr.write("config set requires a key.\n");
+        process.stderr.write("configure set requires a key.\n");
         process.exit(1);
       }
       const raw = ctx.args[1];
       if (raw === undefined || raw.length === 0) {
         if (!ctx.hasFlag("json")) {
-          process.stderr.write("config set requires a value (or --json).\n");
+          process.stderr.write("configure set requires a value (or --json).\n");
           process.exit(1);
         }
-        process.stderr.write("config set requires a value.\n");
+        process.stderr.write("configure set requires a value.\n");
         process.exit(1);
       }
       configSetRun(program, key, raw, ctx.hasFlag("json"));
@@ -199,23 +204,15 @@ function configSetLeaf(program: CliProgram, mcpSetEnabled: boolean): CliLeaf {
   };
 }
 
-import { configCommandsEnabled, configMcpSetEnabled } from "../config/entry.ts";
-
-/** Built-in `config` router when program.appConfig is set. */
-export function cliBuiltinConfigGroup(program: CliProgram): CliRouter {
+/** `configure get` / `configure set` leaves when app config commands are enabled. */
+export function configureConfigSubcommands(
+  program: CliProgram,
+  mcpSetEnabled = configMcpSetEnabled(program),
+): CliLeaf[] {
   if (!program.appConfig) {
-    throw new Error("config not enabled");
+    throw new Error("configure config subcommands require program.appConfig");
   }
-  return {
-    key: "config",
-    description: "Read or write app configuration.",
-    commands: [configGetLeaf(program), configSetLeaf(program, configMcpSetEnabled(program))],
-  };
+  return [configGetLeaf(program), configSetLeaf(program, mcpSetEnabled)];
 }
 
-export function cliBuiltinConfigGroupIfEnabled(program: CliProgram): CliRouter | undefined {
-  if (!configCommandsEnabled(program)) {
-    return undefined;
-  }
-  return cliBuiltinConfigGroup(program);
-}
+export { configCommandsEnabled };

package/src/builtins/configure.ts

@@ -1,11 +1,23 @@
 import { resolveCapabilities } from "../capabilities.ts";
-import { type CliLeaf, type CliOption, CliOptionKind, type CliProgram } from "../types.ts";
+import { configCommandsEnabled, configMcpSetEnabled } from "../config/entry.ts";
+import {
+  CliFallbackMode,
+  type CliLeaf,
+  type CliOption,
+  CliOptionKind,
+  type CliProgram,
+  type CliRouter,
+} from "../types.ts";
+import { configureConfigSubcommands } from "./config.ts";
 import {
   configureCommandDescription,
   configureCommandNotes,
   configureSyncOptionDescription,
 } from "./configure-copy.ts";
 
+/** Hidden fallback leaf for bare `configure` (interactive / flag modes). */
+export const CONFIGURE_RUN_KEY = "run";
+
 /** Configure command options. */
 export function configureBuiltinOptions(root: CliProgram): CliOption[] {
   const caps = resolveCapabilities(root);
@@ -57,14 +69,33 @@ export function configureBuiltinOptions(root: CliProgram): CliOption[] {
   return opts;
 }
 
-/** Builds the `configure` built-in command. */
-export function cliBuiltinConfigureCommand(root: CliProgram): CliLeaf {
+/** True when argv resolved to `configure get` or `configure set`. */
+export function isConfigureConfigPath(path: string[]): boolean {
+  return path.length >= 2 && (path[1] === "get" || path[1] === "set");
+}
+
+/** Builds the `configure` built-in router. */
+export function cliBuiltinConfigureCommand(root: CliProgram): CliRouter {
   const caps = resolveCapabilities(root);
+  const run: CliLeaf = {
+    key: CONFIGURE_RUN_KEY,
+    hidden: true,
+    description: "Interactive or flag-driven configure (skills, MCP, app config).",
+    handler: () => {},
+  };
+
+  const commands: CliLeaf[] = [run];
+  if (configCommandsEnabled(root)) {
+    commands.push(...configureConfigSubcommands(root, configMcpSetEnabled(root)));
+  }
+
   return {
     key: "configure",
     description: configureCommandDescription(root, caps),
     options: configureBuiltinOptions(root),
     notes: configureCommandNotes(root, caps),
-    handler: () => {},
+    fallbackCommand: CONFIGURE_RUN_KEY,
+    fallbackMode: CliFallbackMode.MissingOnly,
+    commands,
   };
 }

package/src/builtins/dispatch.ts

@@ -11,8 +11,11 @@ import { completionBashScript } from "./completion-bash.ts";
 import { completionFishScript } from "./completion-fish.ts";
 import { cliBuiltinCompletionGroup as completionGroup } from "./completion-group.ts";
 import { completionZshScript } from "./completion-zsh.ts";
-import { cliBuiltinConfigGroupIfEnabled } from "./config.ts";
-import { cliBuiltinConfigureCommand } from "./configure.ts";
+import {
+  CONFIGURE_RUN_KEY,
+  cliBuiltinConfigureCommand,
+  isConfigureConfigPath,
+} from "./configure.ts";
 import { cliBuiltinMcpCommand } from "./mcp.ts";
 import { cliPresentationRoot } from "./presentation.ts";
 import { cliBuiltinVersionCommand } from "./version.ts";
@@ -101,7 +104,11 @@ export async function dispatchBuiltin(
       process.stderr.write(capabilityDeniedMessage("configure"));
       process.exit(1);
     }
-    if (pr.path.length !== 1) {
+    if (isConfigureConfigPath(pr.path)) {
+      return;
+    }
+    const runSeg = pr.path[1];
+    if (pr.path.length > 2 || (pr.path.length === 2 && runSeg !== CONFIGURE_RUN_KEY)) {
       process.stderr.write(`Unknown subcommand: configure ${pr.path.slice(1).join(" ")}\n`);
       process.exit(1);
     }
@@ -177,17 +184,5 @@ export function builtinInterceptRoot(
     };
   }
 
-  const configGroup = cliBuiltinConfigGroupIfEnabled(program);
-  if (first === "config" && configGroup) {
-    return {
-      parseRoot: {
-        key: program.key,
-        description: program.description,
-        commands: [configGroup],
-      },
-      isLeafCompletionIntercept: false,
-    };
-  }
-
   return { parseRoot: program, isLeafCompletionIntercept: false };
 }

package/src/builtins/registry.ts

@@ -2,7 +2,6 @@ import type { CliCapabilities } from "../capabilities.ts";
 import { cliBuiltinDocsGroupIfEnabled } from "../docs/builtin.ts";
 import type { CliNode, CliProgram } from "../types.ts";
 import { cliBuiltinCompletionGroup } from "./completion-group.ts";
-import { cliBuiltinConfigGroupIfEnabled } from "./config.ts";
 import { cliBuiltinConfigureCommand } from "./configure.ts";
 import { cliBuiltinMcpCommand } from "./mcp.ts";
 import { cliBuiltinVersionCommand } from "./version.ts";
@@ -37,6 +36,5 @@ export function resolveBuiltins(program: CliProgram, caps: CliCapabilities): Cli
   if (caps.mcp) {
     pushBuiltin(builtins, program, (p) => cliBuiltinMcpCommand(p));
   }
-  pushBuiltin(builtins, program, (p) => cliBuiltinConfigGroupIfEnabled(p) ?? null);
   return builtins;
 }

package/src/capabilities.ts

@@ -42,17 +42,17 @@ export function reservedCommandNames(caps: CliCapabilities): string[] {
   if (caps.mcp) {
     names.push("mcp");
   }
-  if (caps.configCommands) {
-    names.push("config");
-  }
   return names;
 }
 
 /** Commands that may run without required appConfig values (read-only / config introspection). */
 export function skipsRequiredAppConfigExit(path: string[], caps: CliCapabilities): boolean {
   const root = path[0];
-  if (root === "config" && caps.configCommands) {
-    return true;
+  if (root === "configure" && caps.configCommands) {
+    const sub = path[1];
+    if (sub === "get" || sub === "set") {
+      return true;
+    }
   }
   if (root === "docs" && caps.docs) {
     return true;
@@ -60,7 +60,7 @@ export function skipsRequiredAppConfigExit(path: string[], caps: CliCapabilities
   return false;
 }
 
-export type CapabilityFeature = "mcp" | "configure" | "docs" | "config" | "completion";
+export type CapabilityFeature = "mcp" | "configure" | "docs" | "completion";
 
 /** Stderr message when a disabled built-in is invoked from the CLI. */
 export function capabilityDeniedMessage(feature: CapabilityFeature): string {
@@ -73,8 +73,6 @@ export function capabilityDeniedMessage(feature: CapabilityFeature): string {
       return "Configure is not available for this app.\n";
     case "docs":
       return "Documentation commands are not available for this app.\n";
-    case "config":
-      return "Configuration commands are not available for this app.\n";
   }
 }
 
@@ -100,8 +98,4 @@ export function assertBuiltinAllowed(argv: string[], caps: CliCapabilities): voi
     process.stderr.write(capabilityDeniedMessage("docs"));
     process.exit(1);
   }
-  if (first === "config" && !caps.configCommands) {
-    process.stderr.write(capabilityDeniedMessage("config"));
-    process.exit(1);
-  }
 }

package/src/config/entry.ts

@@ -29,7 +29,7 @@ export function configEntryRequired(
   return true;
 }
 
-/** Whether prompts and `config get` should redact this entry. */
+/** Whether prompts and `configure get` should redact this entry. */
 export function configEntrySensitive(key: string, entry: CliAppConfigEntry): boolean {
   return entry.sensitive ?? defaultConfigEntrySensitive(key);
 }
@@ -56,7 +56,7 @@ export function jsonSchemaRequiredKeys(
   return new Set(required.filter((k): k is string => typeof k === "string"));
 }
 
-/** Whether built-in config get/set commands are enabled. */
+/** Whether built-in `configure get` / `configure set` subcommands are enabled. */
 export function configCommandsEnabled(program: CliProgram): boolean {
   if (!program.appConfig) {
     return false;

package/src/config/resolve.ts

@@ -227,7 +227,7 @@ export function formatMissingConfigMessage(program: CliProgram, keys: string[]):
   return [
     `Missing required configuration: ${list}`,
     `Configure interactively:  ${program.key} configure`,
-    `Or set via:               ${program.key} config set <key> <value>`,
+    `Or set via:               ${program.key} configure set <key> <value>`,
     `Config file:              ${path}`,
     `See:                      ${program.key} docs mcp`,
   ].join("\n");
@@ -240,7 +240,7 @@ export function formatMcpMissingConfigMessage(program: CliProgram, keys: string[
   return [
     `Missing required configuration: ${list}`,
     `Configure: ${program.key} configure`,
-    `Or set via: ${program.key} config set`,
+    `Or set via: ${program.key} configure set`,
     `Config file: ${path}`,
   ].join("\n");
 }

package/src/docs/docs.test.ts

@@ -167,7 +167,7 @@ test("skipsRequiredAppConfigExit includes docs and config builtins", () => {
   };
   const caps = resolveCapabilities(program);
   expect(skipsRequiredAppConfigExit(["docs", "api"], caps)).toBe(true);
-  expect(skipsRequiredAppConfigExit(["config", "get"], caps)).toBe(true);
+  expect(skipsRequiredAppConfigExit(["configure", "get"], caps)).toBe(true);
   expect(skipsRequiredAppConfigExit(["run"], caps)).toBe(false);
 });
 

package/src/schema.ts

@@ -13,7 +13,7 @@ import {
   leafOutputSchema,
 } from "./types.ts";
 
-const RESERVED = new Set(["completion", "configure", "docs", "mcp", "version", "config"]);
+const RESERVED = new Set(["completion", "configure", "docs", "mcp", "version"]);
 
 function exportCommand(cmd: CliNode, root: CliProgram): CliSchemaExport | null {
   if (cmd.hidden) {

package/src/types.ts

@@ -236,7 +236,7 @@ export interface CliAppConfigEntry {
   /** When `false`, optional for bootstrap and MCP enforcement. Default: `true`. */
   required?: boolean;
   /**
-   * Mask stdin during prompts and redact on `config get`.
+   * Mask stdin during prompts and redact on `configure get`.
    * Default: `/key|token|secret|password/i.test(name)`.
    */
   sensitive?: boolean;
@@ -253,7 +253,7 @@ export interface CliAppConfigEntry {
  * App configuration block on the program root ({@link CliProgram.appConfig}).
  */
 export interface CliAppConfig {
-  /** Built-in `config get` / `config set`. Default: enabled when `appConfig` is set. */
+  /** Built-in `configure get` / `configure set`. Default: enabled when `appConfig` is set. */
   commands?: boolean | { enabled?: boolean; mcpSet?: boolean };
   /** Block JSON Schema (draft-07). When omitted, synthesize all-string schema from `entries`. */
   jsonSchema?: Record<string, unknown>;