mcpick 0.0.21 → 0.0.23

package/dist/{cache-D6kd7qE8.js → cache-DTfzTsEE.js}

@@ -1,5 +1,5 @@
-import { a as list_linked_plugins, c as read_installed_plugins, d as refresh_all_marketplaces, f as scan_all_cache_keys, i as link_local_plugin, n as clear_plugin_caches, p as unlink_local_plugin, r as get_cached_plugins_info, t as clean_orphaned_versions } from "./plugin-cache-Bby9Dxm9.js";
-import { n as output, t as error } from "./output-BchYq0mR.js";
+import { a as list_linked_plugins, c as read_installed_plugins, d as refresh_all_marketplaces, f as scan_all_cache_keys, i as link_local_plugin, n as clear_plugin_caches, p as unlink_local_plugin, r as get_cached_plugins_info, t as clean_orphaned_versions } from "./plugin-cache-BSgB42wa.js";
+import { n as output, t as error } from "./output-HtT5HCof.js";
 import { defineCommand } from "citty";
 var cache_default = defineCommand({
 	meta: {
@@ -223,4 +223,4 @@ var cache_default = defineCommand({
 //#endregion
 export { cache_default as default };
 
-//# sourceMappingURL=cache-D6kd7qE8.js.map
+//# sourceMappingURL=cache-DTfzTsEE.js.map

package/dist/cli-By-0nYNQ.js

@@ -0,0 +1,112 @@
+import { defineCommand, renderUsage, runMain } from "citty";
+//#region src/cli/index.ts
+const main = defineCommand({
+	meta: {
+		name: "mcpick",
+		description: "Vendor-neutral MCP configuration manager with first-class Claude Code support"
+	},
+	subCommands: {
+		list: () => import("./list-D5CkCXpP.js").then((m) => m.default),
+		enable: () => import("./enable--3mjSmTq.js").then((m) => m.default),
+		disable: () => import("./disable-BaOs9lrm.js").then((m) => m.default),
+		clients: () => import("./clients-qMozizys.js").then((m) => m.default),
+		remove: () => import("./remove-26XFzkPd.js").then((m) => m.default),
+		add: () => import("./add-LJQa2my2.js").then((m) => m.default),
+		"add-json": () => import("./add-json-TEdYweZ5.js").then((m) => m.default),
+		clone: () => import("./clone-BVhYjRGO.js").then((m) => m.default),
+		get: () => import("./get-CjhNWyRj.js").then((m) => m.default),
+		"reset-project-choices": () => import("./reset-project-choices-D2F04LfC.js").then((m) => m.default),
+		backup: () => import("./backup-kyS5IVIr.js").then((m) => m.default),
+		restore: () => import("./restore-BYYsoNqF.js").then((m) => m.default),
+		profile: () => import("./profile-Dq3ORPil.js").then((m) => m.default),
+		skills: () => import("./skills-DfWk9mpk.js").then((m) => m.default),
+		plugins: () => import("./plugins-Dn2mPFKm.js").then((m) => m.default),
+		hooks: () => import("./hooks-DFmxgD0t.js").then((m) => m.default),
+		cache: () => import("./cache-DTfzTsEE.js").then((m) => m.default),
+		dev: () => import("./dev-Cst8WkQ-.js").then((m) => m.default),
+		marketplace: () => import("./marketplace-C3EGyIG0.js").then((m) => m.default),
+		reload: () => import("./reload-257iU7Z7.js").then((m) => m.default),
+		rollback: () => import("./rollback-CPdaME91.js").then((m) => m.default)
+	}
+});
+/**
+* Custom help renderer that appends workflow guidance and examples
+* after citty's standard help output. This is critical for LLM agents
+* that rely on --help output to understand multi-step workflows.
+*/
+async function show_usage_with_examples(cmd, parent) {
+	const base = await renderUsage(cmd, parent);
+	if ((await (typeof cmd.meta === "function" ? cmd.meta() : cmd.meta))?.name === "mcpick") console.log(base + "\n" + WORKFLOW_SECTION + "\n" + CONCEPTS_SECTION + "\n" + EXAMPLES_SECTION + "\n");
+	else console.log(base + "\n");
+}
+const WORKFLOW_SECTION = `
+\x1b[4m\x1b[1mWORKFLOW\x1b[22m\x1b[24m MCPick has two vendor-neutral layers and one Claude Code-specific layer.
+
+  MCP servers: toggle configured servers per client with mcpick list/enable/disable/clients.
+  Skills: install portable SKILL.md packs through the external skills CLI via mcpick skills.
+  Claude Code plugins/hooks/marketplaces: client-specific commands under plugins/hooks/marketplace/cache.`;
+const CONCEPTS_SECTION = `
+\x1b[4m\x1b[1mCONCEPTS\x1b[22m\x1b[24m
+
+  Marketplace   Claude Code-specific plugin catalog hosted on GitHub, GitLab, or locally
+  Plugin        Claude Code bundle containing any mix of: skills, hooks, agents, MCP servers
+  Skill         Portable SKILL.md instruction pack installed into one or more agent clients
+  MCP server    A tool server providing external capabilities to an AI client
+  MCP client    An application that loads MCP server config (Claude Code, Gemini CLI, VS Code, Cursor, OpenCode, Pi via pi-mcp-adapter, etc.)
+  Hook          An event handler that runs on tool use, session start, etc.
+  Profile       A saved snapshot of your MCP server and plugin configuration`;
+const EXAMPLES_SECTION = `
+\x1b[4m\x1b[1mEXAMPLES\x1b[22m\x1b[24m
+
+  Add a marketplace from GitHub (owner/repo):
+    mcpick marketplace add spences10/claude-code-toolkit
+
+  Add a marketplace from a full URL:
+    mcpick marketplace add https://github.com/spences10/claude-code-toolkit
+
+  Install a plugin from a marketplace:
+    mcpick plugins install my-plugin@claude-code-toolkit
+
+  List all installed plugins and their status:
+    mcpick plugins list
+
+  Toggle an MCP server on or off:
+    mcpick enable my-server
+    mcpick disable my-server
+
+  List all MCP servers for Claude Code:
+    mcpick list
+
+  List servers for another client:
+    mcpick list --client gemini-cli --scope project
+    mcpick list --client opencode --scope project
+    mcpick list --client pi --scope user
+
+  Show supported client config locations:
+    mcpick clients
+
+  List portable skills installed for Pi:
+    mcpick skills list --agent pi --json
+
+  See skills available from a repo without installing:
+    mcpick skills add spences10/skills --list
+
+  Install one portable skill for Pi:
+    mcpick skills add spences10/skills --agent pi --skill svelte-runes --yes
+
+  Install all portable skills for OpenCode globally:
+    mcpick skills add spences10/skills --agent opencode --skill '*' --global --yes
+
+  Update portable skills non-interactively:
+    mcpick skills update --global --yes
+
+  Remove a portable skill for Pi:
+    mcpick skills remove svelte-runes --agent pi --yes
+
+  Prefer --json for machine-readable output where supported. MCPick redacts known secret patterns before printing.
+  Run without arguments to launch the interactive TUI (not suitable for LLM agents).`;
+const run = () => runMain(main, { showUsage: show_usage_with_examples });
+//#endregion
+export { run };
+
+//# sourceMappingURL=cli-By-0nYNQ.js.map

package/dist/clients-qMozizys.js

@@ -0,0 +1,30 @@
+import { N as list_client_locations } from "./index.js";
+import { n as output } from "./output-HtT5HCof.js";
+import { defineCommand } from "citty";
+//#region src/cli/commands/clients.ts
+var clients_default = defineCommand({
+	meta: {
+		name: "clients",
+		description: "List supported MCP clients and known config locations"
+	},
+	args: { json: {
+		type: "boolean",
+		description: "Output as JSON",
+		default: false
+	} },
+	async run({ args }) {
+		const locations = await list_client_locations();
+		if (args.json) {
+			output(locations, true);
+			return;
+		}
+		for (const location of locations) {
+			const status = location.exists ? "found" : "missing";
+			console.log(`${location.client}:${location.scope}  ${status}  ${location.path}`);
+		}
+	}
+});
+//#endregion
+export { clients_default as default };
+
+//# sourceMappingURL=clients-qMozizys.js.map

package/dist/{clone-DYKPEsar.js → clone-BVhYjRGO.js}

@@ -1,9 +1,8 @@
 import { n as validate_mcp_server } from "./validation-xMlbgGCF.js";
-import { t as add_server_to_registry } from "./registry-CfUKT7_C.js";
-import { t as add_mcp_via_cli } from "./claude-cli-DnmBJrjg.js";
-import { i as find_server_in_scope, r as detect_server_scope } from "./config-DijVdEFn.js";
-import { n as output, t as error } from "./output-BchYq0mR.js";
-import { t as redact_server } from "./redact-O35tjnRD.js";
+import { i as find_server_in_scope, r as detect_server_scope } from "./config-DzMmTJYL.js";
+import { n as redact_server } from "./redact-wBMtzbno.js";
+import { d as add_mcp_via_cli, w as add_server_to_registry } from "./index.js";
+import { n as output, t as error } from "./output-HtT5HCof.js";
 import { defineCommand } from "citty";
 //#region src/cli/commands/clone.ts
 var clone_default = defineCommand({
@@ -85,4 +84,4 @@ var clone_default = defineCommand({
 //#endregion
 export { clone_default as default };
 
-//# sourceMappingURL=clone-DYKPEsar.js.map
+//# sourceMappingURL=clone-BVhYjRGO.js.map

package/dist/{config-DijVdEFn.js → config-DzMmTJYL.js}

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./rolldown-runtime-CiIaOW0V.js";
 import { i as get_claude_config_path, o as get_current_project_path, v as get_project_mcp_json_path } from "./paths-BPISiJi4.js";
 import { t as validate_claude_config } from "./validation-xMlbgGCF.js";
-import { t as atomic_json_write } from "./atomic-write-BqEykHp9.js";
+import { W as atomic_json_write } from "./index.js";
 import { access, readFile } from "node:fs/promises";
 //#region src/core/config.ts
 var config_exports = /* @__PURE__ */ __exportAll({
@@ -173,4 +173,4 @@ async function get_enabled_servers_for_scope(scope) {
 //#endregion
 export { get_enabled_servers as a, write_claude_config as c, find_server_in_scope as i, create_config_from_servers as n, get_enabled_servers_for_scope as o, detect_server_scope as r, read_claude_config as s, config_exports as t };
 
-//# sourceMappingURL=config-DijVdEFn.js.map
+//# sourceMappingURL=config-DzMmTJYL.js.map

package/dist/{dev-DRJRNp7y.js → dev-Cst8WkQ-.js}

@@ -1,8 +1,8 @@
 import { i as get_claude_config_path, o as get_current_project_path, s as get_dev_overrides_path, v as get_project_mcp_json_path } from "./paths-BPISiJi4.js";
-import { t as atomic_json_write } from "./atomic-write-BqEykHp9.js";
-import { i as find_server_in_scope, r as detect_server_scope } from "./config-DijVdEFn.js";
-import { n as output, t as error } from "./output-BchYq0mR.js";
-import { n as redact_server_base } from "./redact-O35tjnRD.js";
+import { i as find_server_in_scope, r as detect_server_scope } from "./config-DzMmTJYL.js";
+import { r as redact_server_base } from "./redact-wBMtzbno.js";
+import { W as atomic_json_write } from "./index.js";
+import { n as output, t as error } from "./output-HtT5HCof.js";
 import { readFile } from "node:fs/promises";
 import { defineCommand } from "citty";
 //#region src/core/dev-override.ts
@@ -262,4 +262,4 @@ var dev_default = defineCommand({
 //#endregion
 export { dev_default as default };
 
-//# sourceMappingURL=dev-DRJRNp7y.js.map
+//# sourceMappingURL=dev-Cst8WkQ-.js.map

package/dist/disable-BaOs9lrm.js

@@ -0,0 +1,83 @@
+import { F as resolve_client_location, I as set_client_server_enabled, M as get_client_adapter, T as get_all_available_servers, b as remove_mcp_via_cli } from "./index.js";
+import { n as output, t as error } from "./output-HtT5HCof.js";
+import { defineCommand } from "citty";
+//#region src/cli/commands/disable.ts
+var disable_default = defineCommand({
+	meta: {
+		name: "disable",
+		description: "Disable an MCP server"
+	},
+	args: {
+		server: {
+			type: "positional",
+			description: "Server name to disable",
+			required: true
+		},
+		client: {
+			type: "string",
+			description: "Client to edit: claude-code, gemini-cli, vscode, cursor, windsurf, opencode, or pi",
+			default: "claude-code"
+		},
+		scope: {
+			type: "string",
+			description: "Scope: local, project, or user (default: local for Claude Code)"
+		},
+		location: {
+			type: "string",
+			description: "Exact config path when a client has multiple matching locations"
+		},
+		json: {
+			type: "boolean",
+			description: "Output as JSON",
+			default: false
+		}
+	},
+	async run({ args }) {
+		if (args.client && args.client !== "claude-code") {
+			await disable_client_server(args.client, args.server, args.scope, args.location, args.json);
+			return;
+		}
+		const scope = args.scope || "local";
+		if (![
+			"local",
+			"project",
+			"user"
+		].includes(scope)) error(`Invalid scope: ${scope}. Use local, project, or user.`);
+		await get_all_available_servers();
+		const result = await remove_mcp_via_cli(args.server, scope);
+		if (!result.success) error(result.error || "Failed to disable server");
+		if (args.json) output({
+			disabled: args.server,
+			client: "claude-code",
+			scope
+		}, true);
+		else console.log(`Disabled '${args.server}' (scope: ${scope})`);
+	}
+});
+async function disable_client_server(client, server, scope, location_path, json) {
+	const adapter = get_client_adapter(client);
+	if (!adapter) error(`Invalid client: ${client}. Use claude-code, gemini-cli, vscode, cursor, windsurf, opencode, or pi.`);
+	if (scope && ![
+		"local",
+		"project",
+		"user"
+	].includes(scope)) error(`Invalid scope: ${scope}. Use local, project, or user.`);
+	try {
+		const location = resolve_client_location(adapter, scope, location_path);
+		const enabled_count = await set_client_server_enabled(adapter, location, server, false);
+		if (json) output({
+			disabled: server,
+			client: adapter.id,
+			scope: location.scope,
+			location: location.path,
+			enabledCount: enabled_count
+		}, true);
+		else console.log(`Disabled '${server}' (${adapter.id}:${location.scope})`);
+	} catch (err) {
+		error(err instanceof Error ? err.message : "Failed to disable server");
+	}
+}
+//#endregion
+export { disable_default as default };
+
+//# sourceMappingURL=disable-BaOs9lrm.js.map

package/dist/enable--3mjSmTq.js

@@ -0,0 +1,84 @@
+import { F as resolve_client_location, I as set_client_server_enabled, M as get_client_adapter, T as get_all_available_servers, d as add_mcp_via_cli } from "./index.js";
+import { n as output, t as error } from "./output-HtT5HCof.js";
+import { defineCommand } from "citty";
+//#region src/cli/commands/enable.ts
+var enable_default = defineCommand({
+	meta: {
+		name: "enable",
+		description: "Enable an MCP server"
+	},
+	args: {
+		server: {
+			type: "positional",
+			description: "Server name to enable",
+			required: true
+		},
+		client: {
+			type: "string",
+			description: "Client to edit: claude-code, gemini-cli, vscode, cursor, windsurf, opencode, or pi",
+			default: "claude-code"
+		},
+		scope: {
+			type: "string",
+			description: "Scope: local, project, or user (default: local for Claude Code)"
+		},
+		location: {
+			type: "string",
+			description: "Exact config path when a client has multiple matching locations"
+		},
+		json: {
+			type: "boolean",
+			description: "Output as JSON",
+			default: false
+		}
+	},
+	async run({ args }) {
+		if (args.client && args.client !== "claude-code") {
+			await enable_client_server(args.client, args.server, args.scope, args.location, args.json);
+			return;
+		}
+		const scope = args.scope || "local";
+		if (![
+			"local",
+			"project",
+			"user"
+		].includes(scope)) error(`Invalid scope: ${scope}. Use local, project, or user.`);
+		const server = (await get_all_available_servers()).find((s) => s.name === args.server);
+		if (!server) error(`Server '${args.server}' not found in registry. Run 'mcpick list' to see available servers.`);
+		const result = await add_mcp_via_cli(server, scope);
+		if (!result.success) error(result.error || "Failed to enable server");
+		if (args.json) output({
+			enabled: server.name,
+			client: "claude-code",
+			scope
+		}, true);
+		else console.log(`Enabled '${server.name}' (scope: ${scope})`);
+	}
+});
+async function enable_client_server(client, server, scope, location_path, json) {
+	const adapter = get_client_adapter(client);
+	if (!adapter) error(`Invalid client: ${client}. Use claude-code, gemini-cli, vscode, cursor, windsurf, opencode, or pi.`);
+	if (scope && ![
+		"local",
+		"project",
+		"user"
+	].includes(scope)) error(`Invalid scope: ${scope}. Use local, project, or user.`);
+	try {
+		const location = resolve_client_location(adapter, scope, location_path);
+		const enabled_count = await set_client_server_enabled(adapter, location, server, true);
+		if (json) output({
+			enabled: server,
+			client: adapter.id,
+			scope: location.scope,
+			location: location.path,
+			enabledCount: enabled_count
+		}, true);
+		else console.log(`Enabled '${server}' (${adapter.id}:${location.scope})`);
+	} catch (err) {
+		error(err instanceof Error ? err.message : "Failed to enable server");
+	}
+}
+//#endregion
+export { enable_default as default };
+
+//# sourceMappingURL=enable--3mjSmTq.js.map

package/dist/{get-Bb1eOOIZ.js → get-CjhNWyRj.js}

@@ -1,5 +1,5 @@
-import { d as mcp_get_via_cli } from "./claude-cli-DnmBJrjg.js";
-import { n as output, t as error } from "./output-BchYq0mR.js";
+import { v as mcp_get_via_cli } from "./index.js";
+import { n as output, t as error } from "./output-HtT5HCof.js";
 import { defineCommand } from "citty";
 //#region src/cli/commands/get.ts
 var get_default = defineCommand({
@@ -38,4 +38,4 @@ var get_default = defineCommand({
 //#endregion
 export { get_default as default };
 
-//# sourceMappingURL=get-Bb1eOOIZ.js.map
+//# sourceMappingURL=get-CjhNWyRj.js.map

package/dist/{hooks-Bmn7pUZa.js → hooks-DFmxgD0t.js}

@@ -1,6 +1,5 @@
-import { o as remove_hook, r as get_all_hooks, t as add_hook } from "./settings-DEcWtzLE.js";
-import { a as redisable_restored_hooks, i as read_disabled_hooks, n as disable_plugin_hook, r as enable_plugin_hook, t as check_restored_hooks } from "./hook-state-Di8lUsPr.js";
-import { n as output, t as error } from "./output-BchYq0mR.js";
+import { H as remove_hook, L as add_hook, c as enable_plugin_hook, l as read_disabled_hooks, o as check_restored_hooks, s as disable_plugin_hook, u as redisable_restored_hooks, z as get_all_hooks } from "./index.js";
+import { n as output, t as error } from "./output-HtT5HCof.js";
 import { defineCommand } from "citty";
 var hooks_default = defineCommand({
 	meta: {
@@ -277,4 +276,4 @@ var hooks_default = defineCommand({
 //#endregion
 export { hooks_default as default };
 
-//# sourceMappingURL=hooks-Bmn7pUZa.js.map
+//# sourceMappingURL=hooks-DFmxgD0t.js.map