mcpick 0.0.3 → 0.0.5

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # mcpick
 
+## 0.0.5
+
+### Patch Changes
+
+- abc8715: fix: improve UI labels and add documentation about global
+  MCP server configuration
+
+## 0.0.4
+
+### Patch Changes
+
+- 25f7d07: chore: remove non-functional launch feature
+
 ## 0.0.3
 
 ### Patch Changes

package/README.md

@@ -6,9 +6,11 @@ context usage and performance.
 
 ## Installation
 
-### One-time Usage
+### One-time Usage (recommended)
 
 ```bash
+pnpx mcpick
+# or
 pnpm dlx mcpick
 # or
 npx mcpick
@@ -59,8 +61,6 @@ McPick provides an intuitive CLI menu to:
   preserving other Claude Code settings
 - 💾 **Backup & restore** - Create focused backups of your MCP server
   configurations
-- 🚀 **Quick launch** - Start Claude Code with your optimized
-  configuration
 
 ## Features
 
@@ -74,7 +74,6 @@ McPick provides an intuitive CLI menu to:
 │  ○ Backup config
 │  ○ Add MCP server
 │  ○ Restore from backup
-│  ○ Launch Claude Code
 │  ○ Exit
 └
 ```
@@ -103,7 +102,8 @@ McPick provides an intuitive CLI menu to:
 
 1. **Before a coding session**: Run MCPick and enable only relevant
    servers (e.g., just database tools for DB work)
-2. **Launch Claude Code**: Use MCPick's "Launch Claude Code" option
+2. **Launch Claude Code**: Run `claude` to start with your configured
+   servers
 3. **Switch contexts**: Re-run MCPick to enable different servers for
    different tasks
 
@@ -143,6 +143,11 @@ MCPick works with the standard Claude Code configuration format:
   server database)
 - **Backups**: `~/.claude/mcpick/backups/` (MCP configuration backups)
 
+> **Note**: If your MCP servers do not appear in MCPick, ensure they
+> are configured at the global level in Claude Code
+> (`~/.claude.json`), not at the project level (`.claude.json` in your
+> project directory). MCPick manages the global configuration file.
+
 ## Safety Features
 
 - **Non-destructive**: Only modifies the `mcpServers` section of your
@@ -154,6 +159,23 @@ MCPick works with the standard Claude Code configuration format:
 - **Error handling**: Graceful failure modes with helpful error
   messages
 
+## Future Features
+
+McPick is actively being developed with new features planned. See the
+[roadmap](./docs/ROADMAP.md) for details on:
+
+- **Settings Validation** - Validate your Claude Code settings files
+  using the
+  [claude-code-settings-schema](https://github.com/spences10/claude-code-settings-schema)
+- **Permissions Management** - Interactive tool permission
+  configuration with presets (Safe Mode, Dev Mode, Review Mode)
+- **Configuration Profiles** - Save and switch between complete
+  configuration snapshots for different workflows
+
+Have ideas for other features?
+[Open an issue](https://github.com/spences10/mcpick/issues) or check
+out the [contribution guide](./docs/ROADMAP.md)!
+
 ## Requirements
 
 - Node.js 22+

package/dist/commands/edit-config.js

@@ -25,7 +25,7 @@ export async function edit_config() {
             hint: server.description || '',
         }));
         const selected_server_names = await multiselect({
-            message: 'Select MCP servers to enable:',
+            message: 'Select MCP servers to enable (Toggle On/Off servers with spacebar):',
             options: server_choices,
             initialValues: currently_enabled,
             required: false,

package/dist/commands/launch.js

@@ -1,31 +1,20 @@
-import { spinner } from '@clack/prompts';
-import { spawn } from 'node:child_process';
+import { outro } from '@clack/prompts';
+import { execSync } from 'node:child_process';
 export async function launch_claude_code() {
-    const s = spinner();
     try {
-        s.start('Launching Claude Code...');
-        const claude_process = spawn('claude', ['code'], {
-            stdio: 'ignore',
-            detached: true,
+        outro('Launching Claude Code...');
+        // Replace the current process with claude using exec
+        // This ensures the terminal stays valid and Claude gets full control
+        execSync('claude', {
+            stdio: 'inherit',
         });
-        claude_process.unref();
-        await new Promise((resolve, reject) => {
-            claude_process.on('error', (error) => {
-                if (error.message.includes('ENOENT')) {
-                    reject(new Error('Claude Code not found. Make sure it is installed and in your PATH.'));
-                }
-                else {
-                    reject(error);
-                }
-            });
-            setTimeout(() => {
-                resolve(void 0);
-            }, 1000);
-        });
-        s.stop('Claude Code launched successfully!');
     }
     catch (error) {
-        s.stop('Failed to launch Claude Code');
+        if (error instanceof Error && 'status' in error) {
+            // Claude exited normally, just return
+            return;
+        }
+        // Only throw for actual errors (not exit codes)
         throw new Error(`Failed to launch Claude Code: ${error instanceof Error ? error.message : 'Unknown error'}`);
     }
 }

package/dist/index.js

@@ -3,7 +3,6 @@ import { cancel, intro, isCancel, outro, select, } from '@clack/prompts';
 import { add_server } from './commands/add-server.js';
 import { backup_config } from './commands/backup.js';
 import { edit_config } from './commands/edit-config.js';
-import { launch_claude_code } from './commands/launch.js';
 import { restore_config } from './commands/restore.js';
 async function main() {
     intro('MCPick - MCP Server Configuration Manager');
@@ -14,7 +13,7 @@ async function main() {
                 options: [
                     {
                         value: 'edit-config',
-                        label: 'Edit config',
+                        label: 'Enable / Disable MCP servers',
                         hint: 'Toggle MCP servers on/off',
                     },
                     {
@@ -32,11 +31,6 @@ async function main() {
                         label: 'Restore from backup',
                         hint: 'Restore from a previous backup',
                     },
-                    {
-                        value: 'launch',
-                        label: 'Launch Claude Code',
-                        hint: 'Start Claude Code with current config',
-                    },
                     {
                         value: 'exit',
                         label: 'Exit',
@@ -61,9 +55,6 @@ async function main() {
                 case 'restore':
                     await restore_config();
                     break;
-                case 'launch':
-                    await launch_claude_code();
-                    break;
                 case 'exit':
                     outro('Goodbye!');
                     process.exit(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcpick",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Dynamic MCP server configuration manager for Claude Code",
   "type": "module",
   "main": "./dist/index.js",
@@ -25,7 +25,7 @@
   },
   "devDependencies": {
     "@changesets/cli": "^2.29.7",
-    "@types/node": "^24.6.1",
+    "@types/node": "^24.7.0",
     "prettier": "^3.6.2",
     "typescript": "^5.9.3"
   },