{"slug": "cleaned-up-verified-and-translated-version-of-weidwonder-claude-desktop-multi", "title": "Cleaned up, verified and translated version of weidwonder/claude-desktop-multi-instance", "summary": "A developer published a cleaned-up, verified and translated version of the weidwonder/claude-desktop-multi-instance shell script, which launches multiple isolated Claude Desktop instances on macOS using Electron's --user-data-dir flag. Each instance gets its own data directory for config, VM bundles, SDK and sessions, and the script adds an interactive menu, instance listing and deletion, Dock/Launchpad app wrappers, and a diagnostics command.", "body_md": "|  | #!/bin/bash | \n|  | # Claude Desktop Multi-Instance Launcher | \n|  | # | \n|  | # Uses Electron's --user-data-dir flag to run fully isolated instances. | \n|  | # Each instance gets its own data directory (config, VM bundles, SDK, sessions). | \n|  | # | \n|  | # Usage: | \n|  | # ./claude_quick.sh # Show interactive menu | \n|  | # ./claude_quick.sh <instance> # Launch named instance | \n|  | # ./claude_quick.sh list # List all instances | \n|  | # ./claude_quick.sh delete <name> # Delete an instance | \n|  | # ./claude_quick.sh wrapper <name> # Create app wrapper for Dock/Launchpad | \n|  | # ./claude_quick.sh fix # Regenerate wrapper launcher scripts | \n|  | # ./claude_quick.sh diagnose # Diagnose problems | \n|  | INSTANCES_BASE=\"$HOME/.claude-instances\" | \n|  | # ==================== Functions ==================== | \n|  | copy_claude_icon() { | \n|  | local target_dir=\"$1\" | \n|  | local icon=$(find \"/Applications/Claude.app\" -name \"*.icns\" -type f 2>/dev/null \\| head -n 1) | \n|  | if [ -n \"$icon\" ]; then | \n|  | cp \"$icon\" \"$target_dir/claude-icon.icns\" | \n|  | echo \"✅ Copied icon: $(basename \"$icon\")\" | \n|  | else | \n|  | echo \"⚠️ No icon found, wrapper will use default macOS icon\" | \n|  | fi | \n|  | } | \n|  | list_instance_names() { | \n|  | ls -1 \"$INSTANCES_BASE\" 2>/dev/null | \n|  | } | \n|  | # List all instance names including the virtual \"default\" instance. | \n|  | list_all_instance_names() { | \n|  | echo \"default\" | \n|  | list_instance_names | \n|  | } | \n|  | # Find the .app wrapper for a given instance by checking its config.sh. | \n|  | find_wrapper_for_instance() { | \n|  | local target=\"$1\" | \n|  | for app in /Applications/*.app; do | \n|  | local config=\"$app/Contents/MacOS/config.sh\" | \n|  | [ ! -f \"$config\" ] && continue | \n|  | local name=$(grep \"^INSTANCE_NAME=\" \"$config\" 2>/dev/null \\| head -1 \\| sed 's/^INSTANCE_NAME=//') | \n|  | if [ \"$name\" = \"$target\" ]; then | \n|  | echo \"$app\" | \n|  | return 0 | \n|  | fi | \n|  | done | \n|  | return 1 | \n|  | } | \n|  | # List all .app bundles that have a config.sh (i.e., Claude instance wrappers). | \n|  | find_all_wrappers() { | \n|  | for app in /Applications/*.app; do | \n|  | [ -f \"$app/Contents/MacOS/config.sh\" ] && echo \"$app\" | \n|  | done | \n|  | } | \n|  | # Extract the instance name from a wrapper's config.sh. | \n|  | get_wrapper_instance_name() { | \n|  | local config=\"$1/Contents/MacOS/config.sh\" | \n|  | grep \"^INSTANCE_NAME=\" \"$config\" 2>/dev/null \\| head -1 \\| sed 's/^INSTANCE_NAME=//' | \n|  | } | \n|  | list_instances() { | \n|  | echo \"Claude Desktop Instances\" | \n|  | echo \"========================\" | \n|  | echo \"\" | \n|  | # Default instance (uses Claude's built-in data directory) | \n|  | local wrapper_status=\"no wrapper\" | \n|  | find_wrapper_for_instance \"default\" &>/dev/null && wrapper_status=\"has wrapper\" | \n|  | echo \" - default ($wrapper_status, built-in)\" | \n|  | local count=0 | \n|  | for dir in \"$INSTANCES_BASE\"/*/; do | \n|  | [ ! -d \"$dir\" ] && continue | \n|  | local name=$(basename \"$dir\") | \n|  | local wrapper_status=\"no wrapper\" | \n|  | find_wrapper_for_instance \"$name\" &>/dev/null && wrapper_status=\"has wrapper\" | \n|  | echo \" - $name ($wrapper_status)\" | \n|  | count=$((count + 1)) | \n|  | done | \n|  | echo \"\" | \n|  | } | \n|  | diagnose() { | \n|  | echo \"🔍 Claude Desktop Diagnostics\" | \n|  | echo \"==============================\" | \n|  | echo \"\" | \n|  | if [ ! -d \"/Applications/Claude.app\" ]; then | \n|  | echo \"❌ Claude.app not found in /Applications\" | \n|  | echo \" Download from https://claude.ai/download\" | \n|  | return | \n|  | fi | \n|  | echo \"✅ Claude.app installed\" | \n|  | echo \"\" | \n|  | echo \"App wrappers:\" | \n|  | local found=false | \n|  | while IFS= read -r app; do | \n|  | found=true | \n|  | local instance=$(get_wrapper_instance_name \"$app\") | \n|  | local display=$(basename \"$app\" .app) | \n|  | echo \" 📱 $display → instance: $instance\" | \n|  | done < <(find_all_wrappers) | \n|  | $found \\|\\| echo \" (none)\" | \n|  | echo \"\" | \n|  | echo \"Instance directories:\" | \n|  | if [ -d \"$INSTANCES_BASE\" ]; then | \n|  | list_instance_names \\| sed 's/^/ - /' \\|\\| echo \" (none)\" | \n|  | else | \n|  | echo \" (no instances directory)\" | \n|  | fi | \n|  | } | \n|  | # Write the static claude-launcher script into a wrapper. | \n|  | # Can be safely regenerated at any time — config.sh holds the instance name. | \n|  | write_launcher_script() { | \n|  | local wrapper_path=\"$1\" | \n|  | local script_path=\"$wrapper_path/Contents/MacOS/claude-launcher\" | \n|  | local main_script=$(which claude_quick.sh 2>/dev/null) | \n|  | if [ -z \"$main_script\" ]; then | \n|  | echo \"❌ 'claude_quick.sh' not found in PATH\" | \n|  | return 1 | \n|  | fi | \n|  | cat > \"$script_path\" << LAUNCHER_EOF | \n|  | #!/bin/bash | \n|  | source \"\\$(dirname \"\\$0\")/config.sh\" | \n|  | exec \"$main_script\" \"\\$INSTANCE_NAME\" | \n|  | LAUNCHER_EOF | \n|  | chmod +x \"$script_path\" | \n|  | } | \n|  | fix_wrappers() { | \n|  | echo \"🔧 Fixing Claude Desktop wrappers\" | \n|  | echo \"==================================\" | \n|  | local found=false | \n|  | while IFS= read -r app; do | \n|  | found=true | \n|  | local instance=$(get_wrapper_instance_name \"$app\") | \n|  | echo \"🔨 Repairing: $(basename \"$app\") (instance: $instance)\" | \n|  | if write_launcher_script \"$app\"; then | \n|  | echo \" ✅ Regenerated launcher script\" | \n|  | else | \n|  | echo \" ❌ Failed to regenerate launcher\" | \n|  | fi | \n|  | if [ ! -f \"$app/Contents/Resources/claude-icon.icns\" ]; then | \n|  | copy_claude_icon \"$app/Contents/Resources\" | \n|  | fi | \n|  | done < <(find_all_wrappers) | \n|  | $found \\|\\| echo \"No wrappers found to fix.\" | \n|  | echo \"✅ Done\" | \n|  | } | \n|  | delete_instance() { | \n|  | local name=\"$1\" | \n|  | if [ -z \"$name\" ]; then | \n|  | echo \"Available instances:\" | \n|  | list_instance_names \\| sed 's/^/ - /' | \n|  | echo \"\" | \n|  | read -p \"Instance name to delete: \" name | \n|  | fi | \n|  | if [ -z \"$name\" ]; then | \n|  | echo \"❌ Invalid instance name\" | \n|  | return 1 | \n|  | fi | \n|  | if is_default_instance \"$name\"; then | \n|  | echo \"❌ Cannot delete the default instance\" | \n|  | return 1 | \n|  | fi | \n|  | if [ ! -d \"$INSTANCES_BASE/$name\" ]; then | \n|  | echo \"❌ Instance '$name' does not exist\" | \n|  | return 1 | \n|  | fi | \n|  | local wrapper=$(find_wrapper_for_instance \"$name\") | \n|  | echo \"⚠️ This will delete:\" | \n|  | echo \" - Data: $INSTANCES_BASE/$name\" | \n|  | [ -n \"$wrapper\" ] && echo \" - Wrapper: $wrapper\" | \n|  | echo \"\" | \n|  | read -p \"Type 'yes' to confirm: \" confirm | \n|  | if [ \"$confirm\" != \"yes\" ]; then | \n|  | echo \"Cancelled.\" | \n|  | return 0 | \n|  | fi | \n|  | rm -rf \"$INSTANCES_BASE/$name\" | \n|  | [ -n \"$wrapper\" ] && rm -rf \"$wrapper\" | \n|  | echo \"✅ Instance '$name' deleted\" | \n|  | } | \n|  | create_app_wrapper() { | \n|  | local instance_name=\"$1\" | \n|  | local display_name=\"$2\" | \n|  | local wrapper_path=\"/Applications/Claude $display_name.app\" | \n|  | if [ -d \"$wrapper_path\" ]; then | \n|  | read -p \"⚠️ Wrapper already exists. Overwrite? (y/N): \" overwrite | \n|  | [ \"$overwrite\" != \"y\" ] && [ \"$overwrite\" != \"Y\" ] && return | \n|  | rm -rf \"$wrapper_path\" | \n|  | fi | \n|  | mkdir -p \"$wrapper_path/Contents/MacOS\" | \n|  | mkdir -p \"$wrapper_path/Contents/Resources\" | \n|  | cat > \"$wrapper_path/Contents/Info.plist\" << EOF | \n|  | <?xml version=\"1.0\" encoding=\"UTF-8\"?> | \n|  | <!DOCTYPE plist PUBLIC \"-//Apple//DTD PLIST 1.0//EN\" \"http://www.apple.com/DTDs/PropertyList-1.0.dtd\"> | \n|  | <plist version=\"1.0\"> | \n|  | <dict> | \n|  | <key>CFBundleExecutable</key> | \n|  | <string>claude-launcher</string> | \n|  | <key>CFBundleIdentifier</key> | \n|  | <string>com.anthropic.claude.$instance_name</string> | \n|  | <key>CFBundleName</key> | \n|  | <string>Claude $display_name</string> | \n|  | <key>CFBundleDisplayName</key> | \n|  | <string>Claude $display_name</string> | \n|  | <key>CFBundleVersion</key> | \n|  | <string>1.0</string> | \n|  | <key>CFBundleShortVersionString</key> | \n|  | <string>1.0</string> | \n|  | <key>CFBundlePackageType</key> | \n|  | <string>APPL</string> | \n|  | <key>CFBundleInfoDictionaryVersion</key> | \n|  | <string>6.0</string> | \n|  | <key>LSMinimumSystemVersion</key> | \n|  | <string>11.0</string> | \n|  | <key>CFBundleIconFile</key> | \n|  | <string>claude-icon</string> | \n|  | <key>NSHighResolutionCapable</key> | \n|  | <true/> | \n|  | </dict> | \n|  | </plist> | \n|  | EOF | \n|  | cat > \"$wrapper_path/Contents/MacOS/config.sh\" << CONFIG_EOF | \n|  | INSTANCE_NAME=$instance_name | \n|  | CONFIG_EOF | \n|  | write_launcher_script \"$wrapper_path\" | \n|  | copy_claude_icon \"$wrapper_path/Contents/Resources\" | \n|  | echo \"✅ Wrapper created: $wrapper_path\" | \n|  | echo \" Search 'Claude $display_name' in Launchpad or drag to Dock.\" | \n|  | } | \n|  | prompt_wrapper_creation() { | \n|  | local instance_name=\"$1\" | \n|  | if [ -z \"$instance_name\" ]; then | \n|  | echo \"Available instances:\" | \n|  | list_all_instance_names \\| sed 's/^/ - /' | \n|  | echo \"\" | \n|  | read -p \"Create wrapper for which instance: \" instance_name | \n|  | fi | \n|  | if [ -z \"$instance_name\" ]; then | \n|  | echo \"❌ Invalid instance name\" | \n|  | return 1 | \n|  | fi | \n|  | if ! is_default_instance \"$instance_name\" && [ ! -d \"$INSTANCES_BASE/$instance_name\" ]; then | \n|  | echo \"❌ Instance '$instance_name' does not exist\" | \n|  | return 1 | \n|  | fi | \n|  | local default_suffix=$(echo \"$instance_name\" \\| awk '{print toupper(substr($0,1,1)) substr($0,2)}') | \n|  | read -p \"App name suffix (will show as 'Claude <suffix>') [$default_suffix]: \" suffix | \n|  | [ -z \"$suffix\" ] && suffix=\"$default_suffix\" | \n|  | create_app_wrapper \"$instance_name\" \"$suffix\" | \n|  | } | \n|  | is_default_instance() { | \n|  | [ \"$1\" = \"default\" ] | \n|  | } | \n|  | launch_instance() { | \n|  | local instance_name=\"$1\" | \n|  | echo \"🚀 Launching instance: $instance_name\" | \n|  | if is_default_instance \"$instance_name\"; then | \n|  | open -n -a \"/Applications/Claude.app\" | \n|  | echo \"✅ Claude Desktop launched (default)\" | \n|  | else | \n|  | local instance_dir=\"$INSTANCES_BASE/$instance_name\" | \n|  | mkdir -p \"$instance_dir\" | \n|  | open -n -a \"/Applications/Claude.app\" --args --user-data-dir=\"$instance_dir\" | \n|  | echo \"✅ Claude Desktop launched\" | \n|  | echo \"📂 Data: $instance_dir\" | \n|  | fi | \n|  | if ! find_wrapper_for_instance \"$instance_name\" &>/dev/null; then | \n|  | echo \"💡 Run '$0 wrapper $instance_name' to create a Dock shortcut.\" | \n|  | fi | \n|  | } | \n|  | # ==================== Main ==================== | \n|  | echo \"======================================\" | \n|  | echo \" Claude Desktop Multi-Instance Launcher\" | \n|  | echo \"======================================\" | \n|  | if [ ! -d \"/Applications/Claude.app\" ]; then | \n|  | echo \"❌ Claude Desktop not found. Install from https://claude.ai/download\" | \n|  | exit 1 | \n|  | fi | \n|  | # Handle subcommands | \n|  | case \"$1\" in | \n|  | list) list_instances; exit 0 ;; | \n|  | delete) delete_instance \"$2\"; exit $? ;; | \n|  | wrapper) prompt_wrapper_creation \"$2\"; exit $? ;; | \n|  | fix) fix_wrappers; exit 0 ;; | \n|  | diagnose) diagnose; exit 0 ;; | \n|  | esac | \n|  | # Direct instance launch | \n|  | if [ -n \"$1\" ]; then | \n|  | launch_instance \"$1\" | \n|  | exit 0 | \n|  | fi | \n|  | # Interactive menu | \n|  | echo \"\" | \n|  | echo \"1. Launch default instance\" | \n|  | echo \"2. Select existing instance\" | \n|  | echo \"3. Create new instance\" | \n|  | echo \"4. Delete instance\" | \n|  | echo \"5. Create app wrapper\" | \n|  | echo \"6. Diagnose problems\" | \n|  | echo \"7. Fix wrappers\" | \n|  | echo \"\" | \n|  | read -p \"Select (1-7): \" choice | \n|  | case $choice in | \n|  | 1) launch_instance \"default\" ;; | \n|  | 2) | \n|  | list_all_instance_names \\| sed 's/^/ - /' | \n|  | echo \"\" | \n|  | read -p \"Instance name: \" name | \n|  | [ -n \"$name\" ] && launch_instance \"$name\" \\|\\| echo \"❌ No name provided\" | \n|  | ;; | \n|  | 3) | \n|  | read -p \"New instance name: \" name | \n|  | if [ -z \"$name\" ]; then | \n|  | echo \"❌ No name provided\" | \n|  | elif is_default_instance \"$name\"; then | \n|  | echo \"❌ 'default' already exists as the built-in instance\" | \n|  | else | \n|  | launch_instance \"$name\" | \n|  | fi | \n|  | ;; | \n|  | 4) delete_instance ;; | \n|  | 5) prompt_wrapper_creation ;; | \n|  | 6) diagnose ;; | \n|  | 7) fix_wrappers ;; | \n|  | *) echo \"Invalid selection.\" ;; | \n|  | esac |", "url": "https://wpnews.pro/news/cleaned-up-verified-and-translated-version-of-weidwonder-claude-desktop-multi", "canonical_source": "https://gist.github.com/de-posthac/bb0a46bbde20aa850ef9c1c2c6f08836", "published_at": "2026-11-21 13:29:13+00:00", "updated_at": "2026-11-21 13:43:28.236052+00:00", "lang": "en", "topics": ["ai-tools", "developer-tools", "ai-products"], "entities": ["Claude Desktop", "Anthropic", "weidwonder", "Electron", "macOS"], "also_reported_by": [], "takeaway": "Electron's --user-data-dir flag lets you run fully isolated Claude Desktop instances, each with its own config, VM bundles, SDK and sessions, by pointing the app at a separate directory under ~/.claude-instances.", "recommendation": null, "alternates": {"html": "https://wpnews.pro/news/cleaned-up-verified-and-translated-version-of-weidwonder-claude-desktop-multi", "markdown": "https://wpnews.pro/news/cleaned-up-verified-and-translated-version-of-weidwonder-claude-desktop-multi.md", "text": "https://wpnews.pro/news/cleaned-up-verified-and-translated-version-of-weidwonder-claude-desktop-multi.txt", "jsonld": "https://wpnews.pro/news/cleaned-up-verified-and-translated-version-of-weidwonder-claude-desktop-multi.jsonld"}}