#! /usr/bin/env bash # ============================================================================== # Settings # ============================================================================== # Default editor to configure (cursor, vscode, or vscode-insiders) SETUP_EDITOR="cursor" # List of config files to symlink from current directory. CONFIG_SOURCES=( "settings.json" "keybindings.json" "snippets" ) # Additional static symlinks to create (source => target) declare -A STATIC_SYMLINKS=( ["cspell/vscode-user-dictionary.txt"]="${HOME}/.cspell/vscode-user-dictionary.txt" ) # Detect current script directory. SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" # Get extensions lockfile path for current editor get_extensions_lock() { echo "${SCRIPT_DIR}/extensions.${SETUP_EDITOR}.lock" } # ============================================================================== # Help # ============================================================================== show_help() { cat << EOF Usage: $(basename "$0") EDITOR COMMAND [OPTIONS] Editors: cursor, c Cursor editor vscode, code, vsc, v Visual Studio Code vscode-insiders, vsci, i Visual Studio Code Insiders windsurf, surf, w Windsurf editor Commands: config, conf Create symlinks for editor config files dump-extensions, dump Export installed editor extensions to a lock file. extensions, ext Install editor extensions from a lock file. Options: --latest When used with the extensions command, installs the latest version of each extension instead of the exact version from the lock file. Description: This script manages editor configuration files and extensions. It can create symlinks for settings, keybindings, and snippets, as well as dump extension lock files and install extensions from them. EOF } # ============================================================================== # Functions # ============================================================================== # Determine editor config directory editor_config_dir() { case "$(uname -s)" in "Darwin") case "${SETUP_EDITOR}" in "cursor") echo "${HOME}/Library/Application Support/Cursor/User" ;; "vscode") echo "${HOME}/Library/Application Support/Code/User" ;; "vscode-insiders") echo "${HOME}/Library/Application Support/Code - Insiders/User" ;; "windsurf") echo "${HOME}/Library/Application Support/Windsurf/User" ;; *) echo "Error: Invalid editor '${SETUP_EDITOR}' for macOS" exit 1 ;; esac ;; "Linux") case "${SETUP_EDITOR}" in "cursor") echo "${HOME}/.config/Cursor/User" ;; "vscode") echo "${HOME}/.config/Code/User" ;; "vscode-insiders") echo "${HOME}/.config/Code - Insiders/User" ;; "windsurf") echo "${HOME}/.config/Windsurf/User" ;; *) echo "Error: Invalid editor '${SETUP_EDITOR}' for Linux" exit 1 ;; esac ;; *) echo "Error: Unsupported operating system" exit 1 ;; esac } # Cross-platform function to resolve symlinks resolve_symlink() { local path="$1" if command -v realpath > /dev/null 2>&1; then realpath "$path" elif [[ "$(uname -s)" == "Darwin" ]]; then # Use printf to safely pass the path to Python python -c "import os, sys; print(os.path.realpath(sys.argv[1]))" "$path" else readlink -f "$path" fi } # Backup and symlink backup_and_link() { local source="$1" local target="$2" local real_target local real_source # Create target directory if it doesn't exist local target_dir target_dir="$(dirname "${target}")" mkdir -p "${target_dir}" # Check if target already exists if [[ -e "${target}" ]]; then # If it's a symlink, check if it points to the same location if [[ -L "${target}" ]]; then real_target="$(resolve_symlink "$target")" real_source="$(resolve_symlink "$source")" if [[ "${real_target}" == "${real_source}" ]]; then echo "Skipping ${target} - already linked to ${source}" return fi fi echo "Backing up existing ${target} to ${target}.bak" mv "${target}" "${target}.bak" fi # Create symlink echo "Creating symlink for ${source} to ${target}" ln -s "${source}" "${target}" } # Create symlinks do_symlink() { # Create editor config directory if it doesn't exist local config_dir config_dir="$(editor_config_dir)" mkdir -p "${config_dir}" for path in "${CONFIG_SOURCES[@]}"; do backup_and_link "${SCRIPT_DIR}/${path}" "${config_dir}/${path}" done # Conditionally add mcp.json for cursor if [[ "${SETUP_EDITOR}" == "cursor" ]]; then STATIC_SYMLINKS["cursor/mcp.json"]="${HOME}/.cursor/mcp.json" fi # Create static symlinks to custom locations for source in "${!STATIC_SYMLINKS[@]}"; do target="${STATIC_SYMLINKS[${source}]}" backup_and_link "${SCRIPT_DIR}/${source}" "${target}" done echo "Symlink setup complete!" } # Find the editor CLI command find_editor_cmd() { local editor_cmd="" local possible_commands=() case "${SETUP_EDITOR}" in "cursor") # Set possible Cursor CLI command locations possible_commands=( "cursor" "/Applications/Cursor.app/Contents/Resources/app/bin/cursor" "${HOME}/Applications/Cursor.app/Contents/Resources/app/bin/cursor" ) ;; "vscode") # Set possible VSCode CLI command locations possible_commands=( "code" "/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code" "${HOME}/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code" ) ;; "vscode-insiders") # Set possible VSCode Insiders CLI command locations possible_commands=( "code-insiders" "/Applications/Visual Studio Code - Insiders.app/Contents/Resources/app/bin/code" "${HOME}/Applications/Visual Studio Code - Insiders.app/Contents/Resources/app/bin/code" ) ;; "windsurf") # Set possible Windsurf CLI command locations possible_commands=( "windsurf" "/Applications/Windsurf.app/Contents/Resources/app/bin/windsurf" "${HOME}/Applications/Windsurf.app/Contents/Resources/app/bin/windsurf" ) ;; *) echo "Error: Invalid editor '${SETUP_EDITOR}'" exit 1 ;; esac # Check for the command in all possible locations for cmd in "${possible_commands[@]}"; do if command -v "${cmd}" > /dev/null 2>&1; then editor_cmd="${cmd}" break fi done if [[ -z "${editor_cmd}" ]]; then echo "Error: ${SETUP_EDITOR} command not found" >&2 exit 1 fi echo "${editor_cmd}" } # Dump installed extensions to extensions.lock do_dump_extensions() { local editor_cmd editor_cmd="$(find_editor_cmd)" local current_date current_date="$(date)" local extensions_lock extensions_lock="$(get_extensions_lock)" { echo "# ${SETUP_EDITOR} Extensions" echo "# Generated on ${current_date}" echo "${editor_cmd}" --list-extensions --show-versions } > "${extensions_lock}" echo "Extensions list dumped to ${extensions_lock}" } # Validate extension line format validate_extension_line() { local line="$1" local extension="" local version="" # Check for exactly one @ symbol local at_count at_count=$(echo "${line}" | grep -o "@" | wc -l) if [[ ${at_count} -ne 1 ]]; then echo "Warning: Invalid format '${line}' - must contain exactly one '@'" return 1 fi # Extract extension and version parts extension="${line%@*}" version="${line#*@}" # Validate extension part (should be publisher.extension) if [[ ! "${extension}" =~ ^[a-zA-Z0-9_-]+\.[a-zA-Z0-9_-]+$ ]]; then echo "Warning: Invalid extension format '${extension}' - must be 'publisher.extension'" return 1 fi # Validate version is not empty and contains valid characters if [[ -z "${version}" ]]; then echo "Warning: Empty version for extension '${extension}'" return 1 fi if [[ ! "${version}" =~ ^[a-zA-Z0-9._-]+$ ]]; then echo "Warning: Invalid version format '${version}' for extension '${extension}'" return 1 fi # Check for leading/trailing whitespace if [[ "${line}" != "${line// /}" ]]; then echo "Warning: Extension line contains spaces: '${line}'" return 1 fi return 0 } # Global variable to cache installed extensions _INSTALLED_EXTENSIONS="" # Get installed extensions with versions, using cache if available installed_extensions() { local editor_cmd="$1" # Populate the cache if it's not already populated. if [[ -z "${_INSTALLED_EXTENSIONS}" ]]; then _INSTALLED_EXTENSIONS="$("${editor_cmd}" --list-extensions --show-versions)" fi echo "${_INSTALLED_EXTENSIONS}" } # Check if extension is already installed, ignoring version is_extension_installed() { local editor_cmd="$1" local extension="$2" # Check if extension exists in cached list installed_extensions "${editor_cmd}" | grep -q "^$(printf '%s' "${extension}" | sed 's/[[\.*^$()+?{|]/\\&/g')@" } # Check if extension is installed with exact version is_exact_version_installed() { local editor_cmd="$1" local extension="$2" local version="$3" # Check if exact extension@version exists in cached list installed_extensions "${editor_cmd}" | grep -q "^$(printf '%s' "${extension}@${version}" | sed 's/[[\.*^$()+?{|]/\\&/g')$" } # Install an extension directly using the marketplace install_extension_direct() { local editor_cmd="$1" local extension="$2" local version="$3" local use_latest="$4" local force_install="$5" local result=0 if [[ "${use_latest}" == "true" ]]; then echo "Installing ${extension} (latest version)" if ! "${editor_cmd}" --install-extension "${extension}" --force; then echo "Warning: Direct install failed for ${extension}" result=1 fi else echo "Installing ${extension}@${version}" local install_cmd=("${editor_cmd}" --install-extension "${extension}@${version}") if [[ "${force_install}" == "true" ]]; then install_cmd+=(--force) fi if ! "${install_cmd[@]}"; then echo "Warning: Direct install failed for ${extension}@${version}" result=1 fi fi return ${result} } # Install an extension via downloading .vsix file install_extension_via_vsix() { local editor_cmd="$1" local extension="$2" local version="$3" local use_latest="$4" local extensions_cache_dir="$5" local result=0 local publisher_id="${extension%%.*}" local extension_id="${extension#*.}" local vsix_path="" local vsix_url="" local install_version="" if [[ "${use_latest}" == "true" ]]; then # Check for jq availability when using --latest flag if ! command -v jq > /dev/null 2>&1; then echo "Error: jq is required when using --latest flag to parse marketplace API responses" echo "Please install jq or remove the --latest flag to use exact versions from the lock file" return 1 fi # In latest mode, we need to first query the marketplace to get the latest version echo "Finding latest version for ${extension}..." # Query the VS Marketplace API to get the extension metadata local metadata_url="https://marketplace.visualstudio.com/_apis/public/gallery/extensionquery" local temp_metadata="${extensions_cache_dir}/metadata-${extension}.json" # Create extensions directory if it doesn't exist mkdir -p "${extensions_cache_dir}" # Use jq to properly construct JSON local request_data request_data=$(jq -n --arg ext "$extension" '{ filters: [{ criteria: [{ filterType: 7, value: $ext }] }], flags: 2 }') # Query the marketplace for extension metadata if ! curl --silent --compressed -X POST -H "Content-Type: application/json" -H "Accept: application/json; api-version=7.2-preview.1" -d "${request_data}" "${metadata_url}" > "${temp_metadata}"; then echo "Warning: Failed to query metadata for ${extension}" rm -f "${temp_metadata}" return 1 fi # Extract the latest version from the response using jq install_version=$(jq -r '.results[0].extensions[0].versions[0].version' "${temp_metadata}" 2> /dev/null) # Clean up metadata file rm -f "${temp_metadata}" # If we couldn't extract a version, use original version as fallback if [[ -z "${install_version}" || "${install_version}" == "null" ]]; then echo "Warning: Could not determine latest version, falling back to lock file version" install_version="${version}" else echo "Latest version of ${extension} is ${install_version}" fi # Set up the download path and URL for the specific version we found vsix_path="${extensions_cache_dir}/${extension}@${install_version}.vsix" vsix_url="https://marketplace.visualstudio.com/_apis/public/gallery/publishers/${publisher_id}/vsextensions/${extension_id}/${install_version}/vspackage" else # In strict mode, use the exact version from the lock file echo "Installing ${extension}@${version} via .vsix" vsix_path="${extensions_cache_dir}/${extension}@${version}.vsix" vsix_url="https://marketplace.visualstudio.com/_apis/public/gallery/publishers/${publisher_id}/vsextensions/${extension_id}/${version}/vspackage" install_version="${version}" fi # Create extensions directory if it doesn't exist mkdir -p "${extensions_cache_dir}" # Download the .vsix file echo "Downloading ${extension}@${install_version}.vsix..." echo " - URL: ${vsix_url}" if ! curl --compressed -L -o "${vsix_path}" "${vsix_url}"; then echo "Warning: Failed to download ${extension}@${install_version}.vsix" rm -f "${vsix_path}" # Clean up potential partial downloads return 1 fi # Install the extension from .vsix file # Note: Installing from .vsix automatically overwrites existing versions echo "Installing extension from ${vsix_path}" if ! "${editor_cmd}" --install-extension "${vsix_path}"; then echo "Warning: Failed to install ${extension}@${install_version} from .vsix" result=1 fi # Clean up the .vsix file after installation attempt rm -f "${vsix_path}" return ${result} } # Install extensions from extensions.lock do_install_extensions() { local editor_cmd editor_cmd="$(find_editor_cmd)" local extensions_cache_dir="${SCRIPT_DIR}/cache/extensions" local extensions_lock extensions_lock="$(get_extensions_lock)" local use_latest="${1:-false}" if [[ ! -f "${extensions_lock}" ]]; then echo "Error: ${extensions_lock} not found" exit 1 fi # Warn the installed extensions cache before we start processing the lock # file. installed_extensions "${editor_cmd}" # Process each extension while IFS= read -r line; do if [[ -n "${line}" && ! "${line}" =~ ^[[:space:]]*# ]]; then # Validate extension line format if ! validate_extension_line "${line}"; then continue fi extension="${line%@*}" version="${line#*@}" # Check if already installed with correct version if [[ "${use_latest}" == "true" ]]; then # In latest mode, just check if extension is installed (any version) if is_extension_installed "${editor_cmd}" "${extension}"; then echo "Extension ${extension} is already installed, skipping" continue fi else # In exact mode, check if the exact version is installed if is_exact_version_installed "${editor_cmd}" "${extension}" "${version}"; then echo "Extension ${extension}@${version} is already installed, skipping" continue elif is_extension_installed "${editor_cmd}" "${extension}"; then echo "Extension ${extension} is installed but wrong version, force-installing ${version}" fi fi # Determine if we need to force install (when wrong version is installed) local force_install="false" if [[ "${use_latest}" == "false" ]] && is_extension_installed "${editor_cmd}" "${extension}"; then force_install="true" fi # For Cursor we need to download and install from .vsix file, as # installation via ID fails with a signature verification error. if [[ "${SETUP_EDITOR}" == "cursor" ]]; then install_extension_via_vsix "${editor_cmd}" "${extension}" "${version}" "${use_latest}" "${extensions_cache_dir}" continue fi if ! install_extension_direct "${editor_cmd}" "${extension}" "${version}" "${use_latest}" "${force_install}"; then echo "Direct installation failed, trying .vsix download method..." install_extension_via_vsix "${editor_cmd}" "${extension}" "${version}" "${use_latest}" "${extensions_cache_dir}" fi fi done < "${extensions_lock}" # Clean up extensions directory if empty rmdir "${extensions_cache_dir}" 2> /dev/null || true echo "Extensions installation complete!" } # ============================================================================== # Main # ============================================================================== main() { if [[ $# -lt 1 ]]; then echo "Error: No editor specified" show_help exit 1 fi if [[ "$1" == "help" || "$1" == "--help" || "$1" == "-h" ]]; then show_help exit 0 fi if [[ $# -lt 2 ]]; then echo "Error: No command specified" show_help exit 1 fi # Set editor from first argument editor="$(echo "${1}" | tr '[:upper:]' '[:lower:]')" case "${editor}" in "vscode" | "code" | "vsc" | "v") SETUP_EDITOR="vscode" ;; "vscode-insiders" | "code-insiders" | "insiders" | "vsci" | "i") SETUP_EDITOR="vscode-insiders" ;; "cursor" | "c") SETUP_EDITOR="cursor" ;; "windsurf" | "wind" | "surf" | "w") SETUP_EDITOR="windsurf" ;; *) echo "Error: Unsupported editor '${editor}'" echo "Supported editors: cursor, vscode (vsc), vscode-insiders (vsci), windsurf (wind)" exit 1 ;; esac # Get command from second argument local command="${2}" shift 2 # Default values for options local use_latest="false" # Parse additional options while [[ $# -gt 0 ]]; do case "$1" in --latest) use_latest="true" shift ;; *) echo "Error: Unknown option '$1'" show_help exit 1 ;; esac done # Handle commands case "${command}" in "config" | "conf") do_symlink ;; "dump-extensions" | "dump") do_dump_extensions ;; "extensions" | "ext") do_install_extensions "${use_latest}" ;; "") echo "Error: No command provided" show_help exit 1 ;; *) echo "Error: Unknown command '${command}'" show_help exit 1 ;; esac } # Run main function. main "$@"