argsbarg 6.3.2 → 7.0.0

package/examples/full-example-json/docs/mcp.md

@@ -8,12 +8,12 @@ full-example-json exposes an MCP server with features similar to the CLI.
 
 ### `.agents` auto-install
 
-When `mcpServer.enabled` is set, `configure --refresh` merges this server into `~/.agents/mcp.json` per the https://dotagentsprotocol.com.
+When `mcpServer.enabled` is set, `configure install` merges this server into `~/.agents/mcp.json` per the https://dotagentsprotocol.com.
 
 Install the CLI first so `full-example-json` is on your PATH (e.g. `brew install full-example-json`).
 
 ```bash
-full-example-json configure --refresh --yes
+full-example-json configure install
 ```
 
 Writes or updates `~/.agents/mcp.json` with a `mcpServers` entry for this app.

package/examples/full-example-json/docs/skill.md

@@ -43,7 +43,7 @@ For full detail, open `reference.md` in this skill directory (same as `full-exam
 
 Install follows the https://dotagentsprotocol.com:
 
-- Auto-install: `full-example-json configure --refresh --yes` when `skill.enabled` → `~/.agents/skills/full-example-json/`
+- Auto-install: `full-example-json configure install` when `skill.enabled` → `~/.agents/skills/full-example-json/`
 - Cursor and most coding agents read `~/.agents/skills/` natively
 
 **Claude Code (manual):** symlink or copy into Claude's skill directory:

package/examples/full-example-json/justfile

@@ -76,30 +76,32 @@ http:
 # Alias for backward compatibility
 install: install-local
 
-# Dev install: build, stage dev formula, brew install, restore release formula
+# Dev install: build, stage dev formula, brew install, refresh agent artifacts
 install-local: uninstall build
     mkdir -p {{tap_parent}}
     ln -sfn '{{justfile_directory()}}' {{tap_path}}
     bun scripts/dev-formula.ts install
     HOMEBREW_NO_ASK=1 brew reinstall --formula {{tap}}/{{cli_key}} || HOMEBREW_NO_ASK=1 brew install --force --formula {{tap}}/{{cli_key}}
     bun scripts/dev-formula.ts reset
-    @echo ""
-    @echo "Next: {{cli_key}} configure"
+    {{cli_key}} configure install
 
 # Remove local dev install, then install from GitHub tap (requires gh auth login)
 install-production: uninstall
     brew tap {{release_repo}} {{tap_git_url}}
     brew install --formula {{release_repo}}/{{cli_key}}
-    @echo ""
-    @echo "Next: {{cli_key}} configure"
+    {{cli_key}} configure install
 
 # Alias for backward compatibility
 reinstall: reinstall-local
 
-# Rebuild binary and swap into Cellar (run install-local first)
+# Rebuild binary and swap into Cellar (run install-local first; run `just refresh` for skills/MCP)
 reinstall-local: build
     install -m 755 dist/{{cli_key}} "$(brew --prefix {{cli_key}})/bin/{{cli_key}}"
 
+# Refresh agent skills/MCP without reinstalling the binary
+refresh:
+    {{cli_key}} configure install
+
 # Lint sources without writing
 lint:
     bun run biome check ./src ./scripts
@@ -112,10 +114,10 @@ run *ARGS:
 schemagen:
     argsbarg schemagen
 
-# Install bun/npm dependencies
 # Install bun/npm dependencies and generate schemas
 setup:
     bun install
+    test -f node_modules/argsbarg/bin/argsbarg && ln -sf ../argsbarg/bin/argsbarg node_modules/.bin/argsbarg
     just schemagen
 
 # Run unit tests (after check)
@@ -139,12 +141,9 @@ test-release:
 typecheck:
     bun run tsc --noEmit
 
-# Undo dev/Homebrew install (formula uninstall hook runs configure --remove-all)
+# Undo dev/Homebrew install (remove agent artifacts, then keg + untap)
 uninstall:
+    @{{cli_key}} configure uninstall --yes 2>/dev/null || just run configure uninstall --yes
     @HOMEBREW_NO_ASK=1 brew uninstall --formula {{tap}}/{{cli_key}} 2>/dev/null || true
     @HOMEBREW_NO_ASK=1 brew uninstall --formula {{tap}}/{{cli_key}}-local 2>/dev/null || true
-    @HOMEBREW_NO_ASK=1 brew untap {{tap}} 2>/dev/null || true
-
-# Remove app config file only
-uninstall-config:
-    just run configure --remove-config --yes
+    @HOMEBREW_NO_ASK=1 brew untap {{tap}} 2>/dev/null || true

package/examples/full-example-json/scripts/formula-shared.ts

@@ -19,17 +19,15 @@ export const formulaInstallRuby = `def install
     generate_completions_from_executable(bin/"${key}", "completion", base_name: "${key}")
   end`;
 
-export const formulaPostInstallRuby = `def post_install
-    system bin/"${key}", "configure", "--refresh", "--yes"
-  end`;
-
-export const formulaUninstallRuby = `def uninstall
-    system bin/"${key}", "configure", "--remove-all", "--yes"
-  end`;
-
 export const formulaCaveatsRuby = `def caveats
     <<~EOS
-      Run \`${key} configure\` to set up agent artifacts and app config (interactive).
+      After install or upgrade:
+        ${key} configure install
+
+      Before uninstall:
+        ${key} configure uninstall
+        brew uninstall <tap>/${key}
+
       Restart MCP chat apps (Cursor, Claude Desktop, etc.) after install or upgrade so they load the updated server.
     EOS
   end`;
@@ -136,10 +134,6 @@ export function renderFormula(coords: FormulaCoords): string {
 
   ${formulaInstallRuby}
 
-  ${formulaPostInstallRuby}
-
-  ${formulaUninstallRuby}
-
   ${formulaCaveatsRuby}
 
   ${formulaTestRuby}

package/index.d.ts

@@ -535,13 +535,12 @@ export interface CliCompletionConfig {
 }
 /** Opt-in agent skill install to `~/.agents/skills/<key>/` (default: disabled). */
 export interface CliSkillConfig {
-	/** When `true`, install and refresh the agent skill via `configure --refresh`. Default false when omitted. */
+	/** When `true`, install the agent skill via `configure install`. Default false when omitted. */
 	enabled?: boolean;
 }
 /** Context for {@link CliConfigureConfig} lifecycle hooks. */
 export interface ConfigureHookContext {
 	program: CliProgram;
-	/** When true, the configure run is `--dry` (hook should not write files). */
 	dry: boolean;
 	paths: {
 		agentsSkillDir: string;
@@ -554,18 +553,18 @@ export interface ConfigureHookContext {
 export interface CliConfigureConfig {
 	/** When `false`, hide/disable `configure` (default: enabled). */
 	enabled?: boolean;
-	/** Per-artifact gates for configure refresh and interactive wizard. See {@link resolveEffectiveInstallTargets}. */
+	/** Per-artifact gates for configure install. See {@link resolveEffectiveInstallTargets}. */
 	targets?: CliConfigureTargets;
-	/** Runs after framework artifacts are installed/refreshed (`configure --refresh`). */
-	afterRefresh?: (ctx: ConfigureHookContext) => void | Promise<void>;
-	/** Runs before framework artifacts are removed (`configure --remove-all`). */
-	beforeRemoveAll?: (ctx: ConfigureHookContext) => void | Promise<void>;
+	/** Runs after framework artifacts are installed (`configure install`). */
+	afterInstall?: (ctx: ConfigureHookContext) => void | Promise<void>;
+	/** Runs before framework artifacts are removed (`configure uninstall`). */
+	beforeUninstall?: (ctx: ConfigureHookContext) => void | Promise<void>;
 }
 /** Boolean or structured gate for one install artifact. */
 export type InstallTargetSpec = boolean | {
 	/** When false, artifact is never installed (even with scoped CLI flags). Default true. */
 	enabled?: boolean;
-	/** When true, included in `configure --refresh`. Default varies by key. */
+	/** When true, included in `configure install`. Default varies by key. */
 	includedInAll?: boolean;
 };
 export interface ResolvedInstallTarget {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "argsbarg",
-  "version": "6.3.2",
+  "version": "7.0.0",
   "main": "./src/index.ts",
   "module": "./src/index.ts",
   "dependencies": {

package/src/builtins/builtins.test.ts

@@ -8,8 +8,8 @@ import type { CliProgram } from "../core/types.ts";
 import { cliBuiltinDocsGroup } from "../docs/builtin.ts";
 import { resolveCapabilities } from "../runtime/capabilities.ts";
 import { completionBashScript, completionFishScript, completionZshScript } from ".";
-import { cliBuiltinConfigureCommand, configureBuiltinOptions } from "./configure.ts";
-import { configureCommandDescription, configureRefreshOptionDescription } from "./configure-copy.ts";
+import { cliBuiltinConfigureCommand } from "./configure.ts";
+import { configureCommandDescription } from "./configure-copy.ts";
 import { exportPresentationBuiltins } from "./export.ts";
 import { cliBuiltinMcpCommand } from "./mcp.ts";
 import { cliParseRoot, cliPresentationRoot } from "./presentation.ts";
@@ -19,6 +19,7 @@ const fixture: CliProgram = {
   version: "0.0.0",
   description: "Demo app.",
   mcpServer: { enabled: true },
+  skill: { enabled: true },
   commands: [
     {
       key: "hello",
@@ -32,21 +33,23 @@ const noMcp: CliProgram = {
   key: "skillonly",
   version: "0.0.0",
   description: "Skills only.",
+  skill: { enabled: true },
   commands: [{ key: "ping", description: "Ping.", handler: () => {} }],
 };
 
 /** Tests for builtins help copy. */
 describe("builtins help copy", () => {
-  test("configure command includes Homebrew-oriented description", () => {
+  test("configure command includes capability-aware description", () => {
     const configure = cliBuiltinConfigureCommand(fixture);
     expect(configure.description).toContain("agent skills");
     expect(configure.description).toContain("MCP config");
     expect(configure.notes).toContain("brew upgrade");
-    const names = configureBuiltinOptions(fixture).map((o) => o.name);
-    expect(names).toContain("refresh");
-    expect(names).toContain("remove-all");
-    expect(names).toContain("status");
-    const yesOpt = configureBuiltinOptions(fixture).find((o) => o.name === "yes");
+    const commandKeys = configure.commands.map((c) => c.key);
+    expect(commandKeys).toContain("install");
+    expect(commandKeys).toContain("uninstall");
+    expect(commandKeys).toContain("status");
+    const uninstall = configure.commands.find((c) => c.key === "uninstall");
+    const yesOpt = uninstall?.options?.find((o) => o.name === "yes");
     expect(yesOpt?.shortName).toBe("y");
   });
 
@@ -54,34 +57,26 @@ describe("builtins help copy", () => {
     const caps = resolveCapabilities(noMcp);
     expect(configureCommandDescription(noMcp, caps)).toBe("Set up agent skills for this app (binary via Homebrew).");
     expect(configureCommandDescription(noMcp, caps)).not.toContain("MCP");
-    expect(configureRefreshOptionDescription(noMcp, caps)).not.toContain("MCP");
     const configure = cliBuiltinConfigureCommand(noMcp);
     expect(configure.description).not.toContain("MCP");
   });
 
-  /** Configure notes mention brew upgrade and interactive configure. */
-  test("configure notes mention brew upgrade and interactive configure", () => {
+  test("configure notes mention brew upgrade and two-step install", () => {
     const configure = cliBuiltinConfigureCommand(fixture);
     expect(configure.notes).toContain("brew upgrade");
-    expect(configure.notes).toContain("configure --refresh --yes");
+    expect(configure.notes).toContain("configure install");
+    expect(configure.notes).toContain("configure uninstall");
+    expect(configure.notes).not.toContain("post_install");
+    expect(configure.notes).not.toContain("uninstall hook");
     expect(configure.notes).toContain(`${fixture.key} configure`);
-
-    const withConfig: CliProgram = {
-      ...fixture,
-      appConfig: {
-        entries: { token: { description: "Token.", env: "TOKEN" } },
-      },
-    };
-    expect(configureBuiltinOptions(withConfig).map((o) => o.name)).toContain("remove-config");
   });
 
-  test("configure -y parses as --yes", () => {
+  test("configure uninstall -y parses as --yes", () => {
     const root = cliParseRoot(fixture);
-    const pr = postParseValidate(root, parse(root, ["configure", "-y", "--refresh"]));
+    const pr = postParseValidate(root, parse(root, ["configure", "uninstall", "-y"]));
     expect(pr.kind).toBe(ParseKind.Ok);
     if (pr.kind === ParseKind.Ok) {
       expect(pr.opts.yes).toBe("1");
-      expect(pr.opts.refresh).toBe("1");
     }
   });
 
@@ -130,11 +125,11 @@ describe("completion emitters", () => {
     expect(fish).toContain("configure");
   });
 
-  test("bash script includes configure flags", () => {
+  test("bash script includes configure subcommands", () => {
     const schema = cliPresentationRoot(fixture);
     const bash = completionBashScript(schema);
     expect(bash).toContain("hello");
-    expect(bash).toContain("--refresh");
+    expect(bash).toContain("install");
   });
 
   test("zsh script registers compdef", () => {
@@ -152,7 +147,6 @@ describe("completion emitters", () => {
 
 /** Tests for schema export builtins. */
 describe("schema export builtins", () => {
-  /** ExportPresentationBuiltins nests configure get/set when appConfig set. */
   test("exportPresentationBuiltins nests configure get/set when appConfig set", () => {
     const withConfig: CliProgram = {
       ...fixture,
@@ -169,7 +163,7 @@ describe("schema export builtins", () => {
     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"]));
+      expect(keys).toEqual(expect.arrayContaining(["get", "set", "install", "uninstall", "status"]));
     }
   });
 
@@ -181,7 +175,6 @@ describe("schema export builtins", () => {
 
 /** Tests for docs skill topic copy. */
 describe("docs skill topic copy", () => {
-  /** Tests that mentions configure when configure is enabled. */
   test("mentions configure when configure is enabled", () => {
     const withDocs: CliProgram = {
       ...noMcp,

package/src/builtins/configure-copy.ts

@@ -12,9 +12,10 @@ const LABEL: Record<Kind, { prose: string; short: string }> = {
 };
 
 function enabledKinds(program: CliProgram, caps: CliCapabilities): Kind[] {
-  const kinds: Kind[] = ["skills"];
-  if (caps.mcp) kinds.push("mcp");
-  if (program.appConfig) kinds.push("config");
+  const kinds: Kind[] = [];
+  if (program.skill?.enabled) kinds.push("skills");
+  if (caps.mcp && program.mcpServer?.enabled) kinds.push("mcp");
+  if (program.appConfig && Object.keys(program.appConfig.entries).length > 0) kinds.push("config");
   return kinds;
 }
 
@@ -29,21 +30,18 @@ function prose(program: CliProgram, caps: CliCapabilities): string {
   return joinEnglish(enabledKinds(program, caps).map((k) => LABEL[k].prose));
 }
 
-function short(program: CliProgram, caps: CliCapabilities): string {
-  return joinEnglish(enabledKinds(program, caps).map((k) => LABEL[k].short));
+/** True when brew caveats should mention `configure install` / `configure uninstall`. */
+export function needsConfigureCaveats(program: CliProgram, caps: CliCapabilities): boolean {
+  return enabledKinds(program, caps).length > 0;
 }
 
 export function configureCommandDescription(program: CliProgram, caps: CliCapabilities): string {
   return `Set up ${prose(program, caps)} for this app (binary via Homebrew).`;
 }
 
-export function configureRefreshOptionDescription(program: CliProgram, caps: CliCapabilities): string {
-  return `Refresh installed ${short(program, caps)}. Used by Homebrew post_install.`;
-}
-
 export function docsSkillTopicDescription(_program: CliProgram, caps: CliCapabilities): string {
   if (caps.configure) {
-    return "Print a reference agent SKILL; run `configure` to install an optimized copy.";
+    return "Print a reference agent SKILL; run `configure install` to install an optimized copy.";
   }
   return "Print a reference agent SKILL for AI agents.";
 }
@@ -53,30 +51,29 @@ export function configureCommandNotes(program: CliProgram, _caps: CliCapabilitie
   const lines = [
     "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).",
     "",
-    "Homebrew post_install runs:",
-    `  ${app} configure --refresh --yes`,
+    "Homebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.",
     "",
-    "Interactive setup (per target):",
-    `  ${app} configure`,
+    "After install or upgrade:",
+    `  ${app} configure install`,
     "",
     "Upgrade:",
     `  brew upgrade ${app}`,
+    `  ${app} configure install`,
     "",
     "Shell completions are installed by Homebrew during brew install.",
     "See: https://docs.brew.sh/Shell-Completion",
     "",
     "See what is installed:",
-    `  ${app} configure --status`,
+    `  ${app} configure status`,
     "",
     "Uninstall:",
+    `  ${app} configure uninstall`,
     `  brew uninstall <tap>/${app}`,
     "",
-    "The formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).",
-    "",
   ];
-  if (program.appConfig) {
-    lines.push("Remove app config only:", `  ${app} configure --remove-config --yes`, "");
+  if (program.appConfig && Object.keys(program.appConfig.entries).length > 0) {
+    lines.push("Set configuration values:", `  ${app} configure set <key> <value>`, "");
   }
-  lines.push("Use --dry to preview changes without writing files.", "Use --json for machine-readable output.");
+  lines.push("Use `configure status --json` for machine-readable output.");
   return lines.join("\n");
 }

package/src/builtins/configure.ts

@@ -1,90 +1,64 @@
 import { configCommandsEnabled, configMcpSetEnabled } from "../config/entry.ts";
-import {
-  CliFallbackMode,
-  type CliLeaf,
-  type CliOption,
-  CliOptionKind,
-  type CliProgram,
-  type CliRouter,
-} from "../core/types.ts";
+import { cliConfigureInstall, cliConfigureStatus, cliConfigureUninstall } from "../configure/index.ts";
+import { type CliLeaf, type CliOption, CliOptionKind, type CliProgram, type CliRouter } from "../core/types.ts";
 import { resolveCapabilities } from "../runtime/capabilities.ts";
 import { configureConfigSubcommands } from "./config.ts";
-import {
-  configureCommandDescription,
-  configureCommandNotes,
-  configureRefreshOptionDescription,
-} from "./configure-copy.ts";
+import { configureCommandDescription, configureCommandNotes } from "./configure-copy.ts";
 
-/** Hidden fallback leaf for bare `configure` (interactive / flag modes). */
-export const CONFIGURE_RUN_KEY = "run";
+const YES_OPTION: CliOption = {
+  name: "yes",
+  description: "Skip uninstall confirmation.",
+  kind: CliOptionKind.Presence,
+  shortName: "y",
+};
 
-/** Configure command options. */
-export function configureBuiltinOptions(root: CliProgram): CliOption[] {
-  const caps = resolveCapabilities(root);
-  const opts: CliOption[] = [
-    {
-      name: "refresh",
-      description: configureRefreshOptionDescription(root, caps),
-      kind: CliOptionKind.Presence,
-    },
-    {
-      name: "remove-all",
-      description: "Remove all detected agent artifacts (skills and MCP).",
-      kind: CliOptionKind.Presence,
-    },
-  ];
+const JSON_OPTION: CliOption = {
+  name: "json",
+  description: "Print status JSON on stdout.",
+  kind: CliOptionKind.Presence,
+};
 
-  if (root.appConfig) {
-    opts.push({
-      name: "remove-config",
-      description: "Remove the app config file only.",
-      kind: CliOptionKind.Presence,
-    });
-  }
+/** 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");
+}
 
-  opts.push(
-    {
-      name: "status",
-      description: "Print what is currently installed (read-only).",
-      kind: CliOptionKind.Presence,
-    },
-    {
-      name: "yes",
-      description: "Skip confirmation (required for --refresh, --remove-all, --remove-config).",
-      kind: CliOptionKind.Presence,
-      shortName: "y",
-    },
-    {
-      name: "dry",
-      description: "Show what would change without writing files.",
-      kind: CliOptionKind.Presence,
-    },
-    {
-      name: "json",
-      description: "Print changed paths or status JSON on stdout.",
-      kind: CliOptionKind.Presence,
+function configureInstallLeaf(program: CliProgram): CliLeaf {
+  return {
+    key: "install",
+    description: "Install agent artifacts and bootstrap app config.",
+    handler: async () => {
+      await cliConfigureInstall(program);
     },
-  );
+  };
+}
 
-  return opts;
+function configureUninstallLeaf(program: CliProgram): CliLeaf {
+  return {
+    key: "uninstall",
+    description: "Remove agent artifacts and app config.",
+    options: [YES_OPTION],
+    handler: async (ctx) => {
+      await cliConfigureUninstall(program, { yes: ctx.hasFlag("yes") });
+    },
+  };
 }
 
-/** 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");
+function configureStatusLeaf(program: CliProgram): CliLeaf {
+  return {
+    key: "status",
+    description: "Print what is currently installed (read-only).",
+    options: [JSON_OPTION],
+    handler: (ctx) => {
+      cliConfigureStatus(program, { json: ctx.hasFlag("json") });
+    },
+  };
 }
 
 /** Builds the `configure` built-in router. */
 export function cliBuiltinConfigureCommand(root: CliProgram): CliRouter {
   const caps = resolveCapabilities(root);
-  const run: CliLeaf = {
-    key: CONFIGURE_RUN_KEY,
-    cli: { hidden: true },
-    description: "Interactive or flag-driven configure (skills, MCP, app config).",
-    handler: () => {},
-  };
-
-  const commands: CliLeaf[] = [run];
+  const commands: CliLeaf[] = [configureInstallLeaf(root), configureUninstallLeaf(root), configureStatusLeaf(root)];
   if (configCommandsEnabled(root)) {
     commands.push(...configureConfigSubcommands(root, configMcpSetEnabled(root)));
   }
@@ -92,10 +66,7 @@ export function cliBuiltinConfigureCommand(root: CliProgram): CliRouter {
   return {
     key: "configure",
     description: configureCommandDescription(root, caps),
-    options: configureBuiltinOptions(root),
     notes: configureCommandNotes(root, caps),
-    fallbackCommand: CONFIGURE_RUN_KEY,
-    fallbackMode: CliFallbackMode.MissingOnly,
     commands,
   };
 }

package/src/builtins/dispatch.ts

@@ -1,4 +1,3 @@
-import { cliConfigure } from "../configure/index.ts";
 import type { ParseResult } from "../core/parse.ts";
 import { ParseKind } from "../core/parse.ts";
 import type { CliNode, CliProgram, CliRouter } from "../core/types.ts";
@@ -12,7 +11,7 @@ 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 { CONFIGURE_RUN_KEY, cliBuiltinConfigureCommand, isConfigureConfigPath } from "./configure.ts";
+import { cliBuiltinConfigureCommand, isConfigureConfigPath } from "./configure.ts";
 import { cliBuiltinHttpCommand } from "./http.ts";
 import { cliBuiltinMcpCommand } from "./mcp.ts";
 import { cliPresentationRoot } from "./presentation.ts";
@@ -115,12 +114,6 @@ export async function dispatchBuiltin(program: CliProgram, pr: ParseResult, opts
     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);
-    }
-    await cliConfigure(program, pr.opts);
   }
 }
 

package/src/builtins/index.ts

@@ -2,7 +2,7 @@ export { completionBashScript } from "./completion-bash.ts";
 export { completionFishScript } from "./completion-fish.ts";
 export { cliBuiltinCompletionGroup } from "./completion-group.ts";
 export { completionZshScript } from "./completion-zsh.ts";
-export { cliBuiltinConfigureCommand, configureBuiltinOptions } from "./configure.ts";
+export { cliBuiltinConfigureCommand } from "./configure.ts";
 export { builtinInterceptRoot, dispatchBuiltin } from "./dispatch.ts";
 export { type CliSchemaExport, exportPresentationBuiltins } from "./export.ts";
 export { cliBuiltinMcpCommand } from "./mcp.ts";

package/src/cli-tool/create.ts

@@ -294,7 +294,9 @@ export function substituteTemplateContent(content: string, opts: CreateOptions):
   out = out.replace(/@@PROTECT(\d+)@@/g, (_, idx: string) => protectedSpans[Number(idx)] ?? "");
 
   if (!opts.devTemplate) {
-    out = out.replace(/"argsbarg":\s*"file:\.\.\/\.\."/, `"argsbarg": "^${argsbargVersion}"`);
+    out = out
+      .replace(/"argsbarg":\s*"workspace:\*"/, `"argsbarg": "^${argsbargVersion}"`)
+      .replace(/"argsbarg":\s*"file:\.\.\/\.\."/, `"argsbarg": "^${argsbargVersion}"`);
   }
 
   return out;

package/src/cli-tool/post-create.ts

@@ -55,6 +55,10 @@ export async function runPostCreate(
                 cwd: abs,
                 stdout: "inherit",
                 stderr: "inherit",
+                env: {
+                  ...process.env,
+                  PATH: `${join(abs, "node_modules/.bin")}:${process.env.PATH ?? ""}`,
+                },
               });
               if (proc.exitCode !== 0) throw new Error("schemagen failed");
             },
@@ -113,7 +117,7 @@ export function printPostCreatePlan(templateId: CreateTemplateId = "cli"): void
   process.stderr.write("Post-create steps:\n");
   process.stderr.write("  1. bun install\n");
   if (templateId === "json") {
-    process.stderr.write("  2. argsbarg schemagen\n");
+    process.stderr.write("  2. just schemagen\n");
     process.stderr.write("  3. bun test\n");
     process.stderr.write("  4. git init + Initial commit (skipped inside existing git work tree)\n");
   } else {

package/src/config/file.ts

@@ -168,6 +168,7 @@ export function uninstallAppConfig(program: CliProgram, dry: boolean): string[]
   if (!dry) {
     if (hasFile) unlinkSync(path);
     if (hasDir) rmSync(dir, { recursive: true, force: true });
+    process.stdout.write(`Removed app config ${displayAppConfigPath(program)}\n`);
   }
   return changed;
 }

package/src/config/resolve.ts

@@ -223,7 +223,7 @@ export function formatMissingConfigMessage(program: CliProgram, keys: string[]):
   const path = displayAppConfigPath(program);
   return [
     `Missing required configuration: ${list}`,
-    `Configure interactively:  ${program.key} configure`,
+    `Configure interactively:  ${program.key} configure install`,
     `Or set via:               ${program.key} configure set <key> <value>`,
     `Config file:              ${path}`,
     `See:                      ${program.key} docs mcp`,