argsbarg 3.4.0 → 3.4.2

package/CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.4.2] - 2026-06-22
+
+### Added
+
+- **`install --mcp`** — also merges into Claude Desktop `claude_desktop_config.json` when Claude Desktop app data is present (macOS, Windows, Linux paths).
+
+### Changed
+
+- **`docs mcp`** — generated guide documents Cursor, Claude Code, and Claude Desktop install targets and platform config paths.
+- **`mcp bundle`** — no longer macOS-only; packs `.mcpb` on any platform when the compiled binary exists.
+
+## [3.4.1] - 2026-06-22
+
+
 ## [3.4.0] - 2026-06-22
 
 ### Added
@@ -345,7 +359,9 @@ 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/v3.4.0...HEAD
+[Unreleased]: https://github.com/bdombro/bun-argsbarg/compare/v3.4.2...HEAD
+[3.4.2]: https://github.com/bdombro/bun-argsbarg/releases/tag/v3.4.2
+[3.4.1]: https://github.com/bdombro/bun-argsbarg/releases/tag/v3.4.1
 [3.4.0]: https://github.com/bdombro/bun-argsbarg/releases/tag/v3.4.0
 [3.3.14]: https://github.com/bdombro/bun-argsbarg/releases/tag/v3.3.14
 [3.3.13]: https://github.com/bdombro/bun-argsbarg/releases/tag/v3.3.13

package/docs/install.md

@@ -31,7 +31,7 @@ myapp install --uninstall --all --yes
 | Fish completion | `--completions` | `~/.config/fish/completions/<key>.fish` |
 | Cursor skill | `--skill` | `~/.cursor/skills/<dir>/` when `~/.cursor` exists |
 | Claude skill | `--skill` | `~/.claude/skills/<dir>/` when `~/.claude` exists |
-| MCP config | `--mcp` | `~/.cursor/mcp.json` and `~/.claude.json` when MCP is enabled |
+| MCP config | `--mcp` | `~/.cursor/mcp.json` (when `~/.cursor` exists), `~/.claude.json` (Claude Code), and Claude Desktop `claude_desktop_config.json` when Claude Desktop app data exists |
 
 `--all` expands to `--bin`, `--completions`, `--skill`, and `--mcp` (when `mcpServer.enabled` is `true`) for both install and uninstall. Missing targets are skipped silently (no error if nothing is on disk or a shell/agent directory does not exist).
 

package/docs/mcp.md

@@ -57,7 +57,23 @@ Add a server entry under `mcpServers` in your Cursor MCP config:
 }
 ```
 
-Use your real binary or script path. For a compiled CLI, `command` can be the installed binary and `args` can be `["ai", "mcp"]`.
+Use your real binary or script path. For a compiled CLI, `command` can be the installed binary and `args` can be `["mcp"]`.
+
+### Claude Code
+
+`install --mcp` merges into `~/.claude.json` under `mcpServers`.
+
+### Claude Desktop
+
+`install --mcp` also merges into Claude Desktop config when app data is present:
+
+| Platform | Path |
+| --- | --- |
+| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
+| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
+| Linux | `~/.config/Claude/claude_desktop_config.json` |
+
+Restart Claude Desktop after config changes. You can also install a **`.mcpb`** bundle via **`mcp bundle`** (see [MCP Bundle](#mcp-bundle-mcp-bundle)).
 
 ### Other MCP hosts
 
@@ -295,7 +311,7 @@ You should get one JSON line on stdout with `result.capabilities` and `result.se
 
 ## MCP Bundle (`mcp bundle`)
 
-When `mcpServer.enabled` is true, **`mcp bundle`** packs a Claude Desktop **`.mcpb`** bundle (macOS-only v1):
+When `mcpServer.enabled` is true, **`mcp bundle`** packs a Claude Desktop **`.mcpb`** bundle:
 
 ```bash
 just build
@@ -305,7 +321,7 @@ just build
 
 Expects the compiled binary at **`dist/<program.key>`** and writes **`dist/<program.key>.mcpb`**. Manifest metadata is generated from your schema (`mcpServerId`, tools, `requiresEnv`). Optional pack-time fields live under **`mcpServer.bundle`** (`author`, `icon`, `longDescription`).
 
-Bare **`myapp mcp`** still runs the stdio MCP server (unchanged for `install --mcp` and MCP hosts). Use **`install --mcp`** for Cursor / Claude Code JSON config.
+Bare **`myapp mcp`** still runs the stdio MCP server (unchanged for `install --mcp` and MCP hosts). Use **`install --mcp`** for Cursor, Claude Code, and Claude Desktop JSON config.
 
 ## Hidden commands and options
 

package/index.d.ts

@@ -422,7 +422,7 @@ export interface PackMcpBundleOpts {
 }
 /**
  * Stages manifest + binary (+ optional icon) and writes a `.mcpb` ZIP.
- * macOS-only v1; requires the compiled binary to exist.
+ * Requires the compiled binary to exist.
  */
 export declare function packMcpBundle(program: CliProgram, opts?: PackMcpBundleOpts): string;
 

package/package.json

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

package/src/builtins/mcp.ts

@@ -6,7 +6,7 @@ import { type CliLeaf, type CliProgram, type CliRouter, CliFallbackMode } from "
 export function cliBuiltinMcpCommand(program: CliProgram): CliRouter {
   const caps = resolveCapabilities(program);
   const lines = [
-    "Stdio MCP server. Add to Cursor or Claude:",
+    "Stdio MCP server. Add to Cursor, Claude Code, or Claude Desktop:",
     "",
     "  command: {argsbarg:program}",
     "  args: mcp",
@@ -28,7 +28,7 @@ export function cliBuiltinMcpCommand(program: CliProgram): CliRouter {
 
   const bundle: CliLeaf = {
     key: "bundle",
-    description: "Pack a Claude Desktop MCP Bundle (.mcpb) from dist/<key> (macOS-only v1).",
+    description: "Pack a Claude Desktop MCP Bundle (.mcpb) from dist/<key>.",
     handler: () => {},
   };
 

package/src/docs/api-guide.ts

@@ -57,7 +57,7 @@ function formatOutputSchemaSection(schema: Record<string, unknown>): string[] {
   return [
     "#### Output",
     "",
-    "JSON Schema for structured stdout (typically with `--json`, or via MCP when the handler emits JSON):",
+    "JSON Schema for output when/if handler emits JSON",
     "",
     "```json",
     JSON.stringify(schema, null, 2),

package/src/docs/docs.test.ts

@@ -102,6 +102,8 @@ test("docs mcp when MCP enabled", async () => {
   expect(result.exitCode).toBe(0);
   expect(result.stdout).toContain("MCP server (myapp)");
   expect(result.stdout).toContain("myapp mcp");
+  expect(result.stdout).toContain("claude_desktop_config.json");
+  expect(result.stdout).toContain("install --mcp --yes");
 });
 
 test("docs rejects unknown subcommand", async () => {
@@ -192,9 +194,11 @@ test("completions offer docs subcommands", () => {
   expect(bash).toContain("skill) echo");
 });
 
-test("generateMcpGuide includes schema URI", () => {
+test("generateMcpGuide includes schema URI and install targets", () => {
   const guide = generateMcpGuide(docsFixture(true));
   expect(guide).toContain("myapp://schema");
+  expect(guide).toContain("~/.cursor/mcp.json");
+  expect(guide).toContain("claude_desktop_config.json");
 });
 
 test("docs --save writes topic file", async () => {

package/src/docs/mcp-guide.ts

@@ -37,7 +37,33 @@ export function generateMcpGuide(root: CliProgram): string {
     `${root.key} mcp`,
     "```",
     "",
-    "Cursor / Claude `mcp.json` entry:",
+    "## Client setup",
+    "",
+    "### `install --mcp`",
+    "",
+    "```bash",
+    `${root.key} install --mcp --yes`,
+    "```",
+    "",
+    "Merges the server entry below into host config when each host is present:",
+    "",
+    "| Host | Config file |",
+    "| --- | --- |",
+    "| Cursor | `~/.cursor/mcp.json` (when `~/.cursor` exists) |",
+    "| Claude Code | `~/.claude.json` |",
+    "| Claude Desktop | `claude_desktop_config.json` (when Claude Desktop app data exists) |",
+    "",
+    "Claude Desktop paths by platform:",
+    "",
+    "- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`",
+    "- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`",
+    "- **Linux:** `~/.config/Claude/claude_desktop_config.json`",
+    "",
+    "Restart Claude Desktop after changing its config.",
+    "",
+    "### Manual entry",
+    "",
+    "Add under `mcpServers` in the host config:",
     "",
     "```json",
     JSON.stringify(
@@ -54,12 +80,6 @@ export function generateMcpGuide(root: CliProgram): string {
     ),
     "```",
     "",
-    "Or run:",
-    "",
-    "```bash",
-    `${root.key} install --mcp --yes`,
-    "```",
-    "",
   ];
 
   if (mcp.shellEnv || mcp.envFile) {

package/src/hidden-mcpb.test.ts

@@ -129,10 +129,7 @@ describe("mcp bundle", () => {
     expect(paths.outPath).toBe(join(cwd, "dist", "myapp.mcpb"));
   });
 
-  test("packMcpBundle writes zip with manifest and binary on darwin", () => {
-    if (process.platform !== "darwin") {
-      return;
-    }
+  test("packMcpBundle writes zip with manifest and binary", () => {
     const work = mkdtempSync(join(tmpdir(), "mcpb-test-"));
     try {
       const dist = join(work, "dist");

package/src/install/detect-installed.ts

@@ -10,6 +10,7 @@ export interface InstalledArtifacts {
   claudeSkill: boolean;
   cursorMcp: boolean;
   claudeMcp: boolean;
+  claudeDesktopMcp: boolean;
   bashRcPath: boolean;
   zshRcFpath: boolean;
 }
@@ -35,6 +36,7 @@ export function detectInstalledArtifacts(paths: InstallPaths): InstalledArtifact
     claudeSkill: existsSync(paths.claudeSkillDir),
     cursorMcp: mcpConfigHasServer(paths.cursorMcpPath, paths.mcpName),
     claudeMcp: mcpConfigHasServer(paths.claudeMcpPath, paths.mcpName),
+    claudeDesktopMcp: mcpConfigHasServer(paths.claudeDesktopMcpPath, paths.mcpName),
     bashRcPath: false,
     zshRcFpath: false,
   };
@@ -49,6 +51,7 @@ export interface InstallStatus {
   claudeSkill?: string;
   cursorMcp?: string;
   claudeMcp?: string;
+  claudeDesktopMcp?: string;
 }
 
 /** Builds a status inventory from detected artifacts. */
@@ -62,5 +65,8 @@ export function buildInstallStatus(paths: InstallPaths, detected: InstalledArtif
   if (detected.claudeSkill) status.claudeSkill = paths.claudeSkillDir + "/";
   if (detected.cursorMcp) status.cursorMcp = `${paths.cursorMcpPath} (server "${paths.mcpName}")`;
   if (detected.claudeMcp) status.claudeMcp = `${paths.claudeMcpPath} (server "${paths.mcpName}")`;
+  if (detected.claudeDesktopMcp) {
+    status.claudeDesktopMcp = `${paths.claudeDesktopMcpPath} (server "${paths.mcpName}")`;
+  }
   return status;
 }

package/src/install/index.ts

@@ -151,7 +151,7 @@ export async function runInstallMutation(
   if (!opts.uninstall && resolveCapabilities(root).mcp && (opts.all || opts.mcp)) {
     const entry = expectedMcpEntry(root);
     const yes = !!opts.yes;
-    for (const p of [paths.cursorMcpPath, paths.claudeMcpPath]) {
+    for (const p of [paths.cursorMcpPath, paths.claudeMcpPath, paths.claudeDesktopMcpPath]) {
       const conflict = checkMcpConflict(p, paths.mcpName, entry, yes);
       if (conflict) {
         throw new Error(conflict);

package/src/install/install.test.ts

@@ -4,7 +4,7 @@ import { join } from "node:path";
 import { tmpdir } from "node:os";
 import { CliProgram } from "../types.ts";
 import { detectInstalledArtifacts } from "./detect-installed.ts";
-import { resolveInstallPaths } from "./paths.ts";
+import { resolveInstallPaths, resolveClaudeDesktopMcpPath } from "./paths.ts";
 import { buildInstallPlan } from "./plan.ts";
 import { buildUninstallPlan } from "./uninstall.ts";
 import { printInstallStatus } from "./status.ts";
@@ -45,6 +45,18 @@ describe("install paths", () => {
     const paths = resolveInstallPaths(fixture, {});
     expect(paths.fishCompletion).toBe(join(xdg, "fish", "completions", "testapp.fish"));
   });
+
+  test("claude desktop mcp path on darwin", () => {
+    const prev = process.platform;
+    Object.defineProperty(process, "platform", { value: "darwin" });
+    try {
+      expect(resolveClaudeDesktopMcpPath(home)).toBe(
+        join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json"),
+      );
+    } finally {
+      Object.defineProperty(process, "platform", { value: prev });
+    }
+  });
 });
 
 describe("detect installed", () => {
@@ -68,6 +80,20 @@ describe("install plan", () => {
     const plan = buildInstallPlan(fixture, paths, parseInstallOpts({ all: "1" }));
     expect(plan.some((a) => a.kind === "binary")).toBe(true);
   });
+
+  test("buildInstallPlan --mcp includes claude desktop when app data exists", () => {
+    const paths = resolveInstallPaths(fixture, {});
+    mkdirSync(join(home, "Library", "Application Support", "Claude"), { recursive: true });
+    const plan = buildInstallPlan(fixture, paths, parseInstallOpts({ mcp: "1" }));
+    expect(plan.some((a) => a.kind === "claude-desktop-mcp")).toBe(process.platform === "darwin");
+    expect(plan.some((a) => a.kind === "claude-mcp")).toBe(true);
+  });
+
+  test("buildInstallPlan --mcp skips claude desktop without app data", () => {
+    const paths = resolveInstallPaths(fixture, {});
+    const plan = buildInstallPlan(fixture, paths, parseInstallOpts({ mcp: "1" }));
+    expect(plan.some((a) => a.kind === "claude-desktop-mcp")).toBe(false);
+  });
 });
 
 describe("install status", () => {

package/src/install/paths.ts

@@ -1,5 +1,6 @@
+import { existsSync } from "node:fs";
 import { homedir } from "node:os";
-import { join } from "node:path";
+import { dirname, join } from "node:path";
 import { CliProgram } from "../types.ts";
 import { sanitizeToolSegment, mcpServerId } from "../mcp/tools.ts";
 
@@ -13,6 +14,7 @@ export interface InstallPaths {
   claudeSkillDir: string;
   cursorMcpPath: string;
   claudeMcpPath: string;
+  claudeDesktopMcpPath: string;
   bashRc: string;
   zshRc: string;
   mcpName: string;
@@ -43,6 +45,24 @@ export function resolveBindir(root: CliProgram, prefix?: string): string {
   return join(userHome(), ".local", "bin");
 }
 
+/** Resolves Claude Desktop `claude_desktop_config.json` for the current OS. */
+export function resolveClaudeDesktopMcpPath(home: string): string {
+  if (process.platform === "darwin") {
+    return join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json");
+  }
+  if (process.platform === "win32") {
+    const appData = process.env.APPDATA ?? join(home, "AppData", "Roaming");
+    return join(appData, "Claude", "claude_desktop_config.json");
+  }
+  const xdgConfig = process.env.XDG_CONFIG_HOME ?? join(home, ".config");
+  return join(xdgConfig, "Claude", "claude_desktop_config.json");
+}
+
+/** True when Claude Desktop app data exists (config file or app support directory). */
+export function claudeDesktopPresent(home: string, configPath: string): boolean {
+  return existsSync(configPath) || existsSync(dirname(configPath));
+}
+
 /** Resolves all install artifact paths for a program root. */
 export function resolveInstallPaths(root: CliProgram, opts: { prefix?: string }): InstallPaths {
   const home = userHome();
@@ -50,6 +70,7 @@ export function resolveInstallPaths(root: CliProgram, opts: { prefix?: string })
   const key = root.key;
   const skillDirName = sanitizeToolSegment(root.key);
   const xdgConfig = process.env.XDG_CONFIG_HOME ?? join(home, ".config");
+  const claudeDesktopMcpPath = resolveClaudeDesktopMcpPath(home);
 
   return {
     bindir,
@@ -61,6 +82,7 @@ export function resolveInstallPaths(root: CliProgram, opts: { prefix?: string })
     claudeSkillDir: join(home, ".claude", "skills", skillDirName),
     cursorMcpPath: join(home, ".cursor", "mcp.json"),
     claudeMcpPath: join(home, ".claude.json"),
+    claudeDesktopMcpPath,
     bashRc: join(home, ".bashrc"),
     zshRc: join(home, ".zshrc"),
     mcpName: mcpServerId(root),

package/src/install/plan.ts

@@ -6,7 +6,7 @@ import { installBinary } from "./binary.ts";
 import { installCompletions } from "./completions.ts";
 import { detectInstalledArtifacts } from "./detect-installed.ts";
 import { expectedMcpEntry, mergeMcpConfig } from "./mcp-config.ts";
-import { InstallPaths, userHome } from "./paths.ts";
+import { InstallPaths, userHome, claudeDesktopPresent } from "./paths.ts";
 import { detectShells } from "./shell.ts";
 
 export interface InstallOpts {
@@ -27,7 +27,14 @@ export interface InstallOpts {
   prefix?: string;
 }
 
-export type InstallActionKind = "binary" | "completions" | "cursor-skill" | "claude-skill" | "cursor-mcp" | "claude-mcp";
+export type InstallActionKind =
+  | "binary"
+  | "completions"
+  | "cursor-skill"
+  | "claude-skill"
+  | "cursor-mcp"
+  | "claude-mcp"
+  | "claude-desktop-mcp";
 
 export interface InstallAction {
   kind: InstallActionKind;
@@ -139,13 +146,24 @@ export function buildInstallPlan(root: CliProgram, paths: InstallPaths, opts: In
     }
     actions.push({
       kind: "claude-mcp",
-      summary: `claude mcp: ${paths.claudeMcpPath} (server "${paths.mcpName}")`,
+      summary: `claude code mcp: ${paths.claudeMcpPath} (server "${paths.mcpName}")`,
       message: `Merging MCP server "${paths.mcpName}" into ${paths.claudeMcpPath}`,
       run: () => {
         mergeMcpConfig(paths.claudeMcpPath, paths.mcpName, entry, dry);
         return [paths.claudeMcpPath];
       },
     });
+    if (claudeDesktopPresent(userHome(), paths.claudeDesktopMcpPath)) {
+      actions.push({
+        kind: "claude-desktop-mcp",
+        summary: `claude desktop mcp: ${paths.claudeDesktopMcpPath} (server "${paths.mcpName}")`,
+        message: `Merging MCP server "${paths.mcpName}" into ${paths.claudeDesktopMcpPath}`,
+        run: () => {
+          mergeMcpConfig(paths.claudeDesktopMcpPath, paths.mcpName, entry, dry);
+          return [paths.claudeDesktopMcpPath];
+        },
+      });
+    }
   }
 
   return actions;
@@ -158,7 +176,9 @@ export function buildUpdatePlan(root: CliProgram, paths: InstallPaths, opts: Ins
     bin: true,
     completions: detected.bashCompletion || detected.zshCompletion || detected.fishCompletion,
     skill: detected.cursorSkill || detected.claudeSkill,
-    mcp: (detected.cursorMcp || detected.claudeMcp) && resolveCapabilities(root).mcp,
+    mcp:
+      (detected.cursorMcp || detected.claudeMcp || detected.claudeDesktopMcp) &&
+      resolveCapabilities(root).mcp,
     dry: opts.dry,
   };
   const plan = buildInstallPlan(root, paths, scoped);
@@ -180,6 +200,8 @@ export function buildUpdatePlan(root: CliProgram, paths: InstallPaths, opts: Ins
         return detected.cursorMcp;
       case "claude-mcp":
         return detected.claudeMcp;
+      case "claude-desktop-mcp":
+        return detected.claudeDesktopMcp;
       default:
         return false;
     }

package/src/install/status.ts

@@ -35,6 +35,7 @@ export function printInstallStatus(root: CliProgram, opts: InstallOpts): void {
     if (status.claudeSkill) json.claudeSkill = status.claudeSkill;
     if (status.cursorMcp) json.cursorMcp = status.cursorMcp;
     if (status.claudeMcp) json.claudeMcp = status.claudeMcp;
+    if (status.claudeDesktopMcp) json.claudeDesktopMcp = status.claudeDesktopMcp;
     process.stdout.write(JSON.stringify(json, null, 2) + "\n");
     return;
   }
@@ -48,7 +49,8 @@ export function printInstallStatus(root: CliProgram, opts: InstallOpts): void {
     ["cursor skill", status.cursorSkill],
     ["claude skill", status.claudeSkill],
     ["cursor mcp", status.cursorMcp],
-    ["claude mcp", status.claudeMcp],
+    ["claude code mcp", status.claudeMcp],
+    ["claude desktop mcp", status.claudeDesktopMcp],
   ];
   let any = false;
   for (const [label, value] of lines) {

package/src/install/uninstall.ts

@@ -93,7 +93,7 @@ export function buildUninstallPlan(
     }
     if (detected.claudeMcp) {
       actions.push({
-        summary: `claude mcp: ${paths.claudeMcpPath}`,
+        summary: `claude code mcp: ${paths.claudeMcpPath}`,
         message: `Removing MCP server "${paths.mcpName}" from ${paths.claudeMcpPath}`,
         run: () => {
           removeMcpConfig(paths.claudeMcpPath, paths.mcpName, dry);
@@ -101,6 +101,16 @@ export function buildUninstallPlan(
         },
       });
     }
+    if (detected.claudeDesktopMcp) {
+      actions.push({
+        summary: `claude desktop mcp: ${paths.claudeDesktopMcpPath}`,
+        message: `Removing MCP server "${paths.mcpName}" from ${paths.claudeDesktopMcpPath}`,
+        run: () => {
+          removeMcpConfig(paths.claudeDesktopMcpPath, paths.mcpName, dry);
+          return [paths.claudeDesktopMcpPath];
+        },
+      });
+    }
   }
 
   return actions;

package/src/mcp/bundle.ts

@@ -1,6 +1,6 @@
 /*
 Packs a CLI program into an MCP Bundle (`.mcpb`) for Claude Desktop.
-macOS-only v1: expects `dist/<program.key>` as the compiled binary input.
+Expects `dist/<program.key>` as the compiled binary input.
 */
 
 import { cpSync, existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
@@ -198,13 +198,9 @@ export interface PackMcpBundleOpts {
 
 /**
  * Stages manifest + binary (+ optional icon) and writes a `.mcpb` ZIP.
- * macOS-only v1; requires the compiled binary to exist.
+ * Requires the compiled binary to exist.
  */
 export function packMcpBundle(program: CliProgram, opts: PackMcpBundleOpts = {}): string {
-  if (process.platform !== "darwin") {
-    throw new Error("mcp bundle is macOS-only in this release. Build the bundle on darwin.");
-  }
-
   const cwd = opts.cwd ?? process.cwd();
   const defaults = defaultMcpBundlePaths(program, cwd);
   const binaryPath = resolve(cwd, opts.binaryPath ?? defaults.binaryPath);