# VS Code + JetBrains Extension Installers A bundle of cross-platform scripts that install a curated set of editor extensions / plugins, one command per platform. | File | Editor | Platforms | | ----------------------- | ----------------------------------- | ------------------------ | | `install.sh` | VS Code | macOS, Linux (Ubuntu) | | `install.ps1` | VS Code | Windows | | `install-jetbrains.sh` | JetBrains IDEs + remote-dev-server | macOS, Linux, WSL2 | | `install-jetbrains.ps1` | JetBrains IDEs + Gateway Client | Windows | --- ## Quick start Replace `<GIST>` with the raw base of this Gist (everything up to and including `/raw/HEAD/`). ### VS Code ```bash # macOS / Ubuntu (default profile) curl -sSL https://opengist.rmrf.online/weehong/b2a7c0a2ae6d40e8a14f8d85964a9186/raw/HEAD/install.sh | bash # named profile bash <(curl -sSL https://opengist.rmrf.online/weehong/b2a7c0a2ae6d40e8a14f8d85964a9186/raw/HEAD/install.sh) --profile "WorkSetup" ``` ```powershell # Windows iwr -useb https://opengist.rmrf.online/weehong/b2a7c0a2ae6d40e8a14f8d85964a9186/raw/HEAD/install.ps1 | iex # named profile .\install.ps1 -ProfileName "WorkSetup" ``` ### JetBrains ```bash # macOS / Ubuntu / WSL2 — interactive picker for IDEs and plugins bash <(curl -sSL https://opengist.rmrf.online/weehong/b2a7c0a2ae6d40e8a14f8d85964a9186/raw/HEAD/install-jetbrains.sh) ``` ```powershell # Windows — interactive picker iwr -useb https://opengist.rmrf.online/weehong/b2a7c0a2ae6d40e8a14f8d85964a9186/raw/HEAD/install-jetbrains.ps1 | iex ``` --- ## What's in the catalogs ### VS Code extensions - `docker.docker` - `github.github-vscode-theme` - `ms-vscode-remote.vscode-remote-extensionpack` - `pkief.material-icon-theme` (GitHub Copilot Chat is no longer in the list — it ships built-in with VS Code now.) ### JetBrains plugins (canonical marketplace IDs) | xmlId | Plugin | | ------------------------------- | ----------------------------- | | `com.intellij.ml.llm` | JetBrains AI Assistant | | `izhangzhihao.rainbow.brackets` | Rainbow Brackets | | `IdeaVIM` | IdeaVim | | `org.sonarlint.idea` | SonarQube for IDE (SonarLint) | | `Key Promoter X` | Key Promoter X | | `net.ashald.envfile` | EnvFile | | `org.intellij.qodana` | Qodana | Two IDs are easy to get wrong: `IdeaVIM` (xmlId is all-caps `VIM`) and `Key Promoter X` (xmlId contains spaces — must be quoted when passed to `installPlugins`). --- ## VS Code installer details `install.sh` / `install.ps1` are thin wrappers around `code --install-extension`: - `--profile "Name"` / `-ProfileName "Name"` installs into a named profile; VS Code creates the profile if it doesn't exist. - `--force` is passed so re-runs are idempotent. - Both scripts exit non-zero if any extension fails, and print a final summary. Prereq: the `code` CLI must be on `PATH`. - **macOS:** open VS Code → Cmd+Shift+P → "Shell Command: Install 'code' command in PATH". - **Ubuntu:** install from <https://code.visualstudio.com/> or `sudo snap install --classic code`. - **Windows:** during install, check "Add to PATH" (the default). --- ## JetBrains installer details Both JetBrains scripts: 1. Detect the host OS. 2. Scan the system for installed JetBrains IDEs and (where applicable) Gateway / remote-dev targets. 3. Show an interactive multi-select picker for IDEs and another for plugins. 4. Run each IDE's `installPlugins` against every selected plugin. ### What gets scanned #### `install-jetbrains.sh` | OS | Source | | ----- | ---------------------------------------------------------------------------- | | macOS | `~/Library/Application Support/JetBrains/Toolbox/scripts/*` (Toolbox shims) | | macOS | `/Applications/<JetBrains IDE>.app/Contents/MacOS/*` | | Linux | `~/.local/share/JetBrains/Toolbox/apps/*/bin/*.sh` | | Linux | `/opt/*/bin/*.sh` (snap / .deb / tarball) | | Linux | `~/.cache/JetBrains/RemoteDev/dist/*/bin/remote-dev-server.sh` (Gateway, SSH/Orbstack) | | WSL2 | `/mnt/c/Users/<WindowsUser>/AppData/Local/Programs/*/bin/*.exe` | | WSL2 | `/mnt/c/Users/<WindowsUser>/AppData/Local/JetBrains/Toolbox/scripts/*.cmd` | | WSL2 | `~/.cache/JetBrains/RemoteDev/dist/*/bin/remote-dev-server.sh` | WSL2 detection works by grepping `microsoft` in `/proc/version`. The Windows username is read at runtime via `cmd.exe /c 'echo %USERNAME%'`. #### `install-jetbrains.ps1` | Source | What it is | | ------------------------------------------------------- | -------------------------------- | | `%LOCALAPPDATA%\Programs\*\bin\*64.exe` | Standalone + Toolbox app installs| | `%LOCALAPPDATA%\JetBrains\Toolbox\scripts\*.cmd` | Toolbox shims | | `%LOCALAPPDATA%\JetBrains\JetBrainsClient*` (newest) | Gateway Client (special path) | ### Picker - **Bash:** uses `fzf --multi` if `fzf` is on `PATH` (TAB to toggle, Enter to confirm); otherwise prints a numbered list and accepts comma-separated indexes (`1,3,5`) or `a` for all. - **PowerShell:** uses `Out-GridView -OutputMode Multiple` when available; otherwise the same numbered/comma-input fallback. ### Gateway Client path (Windows) When the script detects `%LOCALAPPDATA%\JetBrains\JetBrainsClient*` and you select it from the picker, the install logic switches: the bundled Gateway client has no `installPlugins` CLI, so the script reads the client's `build.txt` and downloads each plugin directly from `plugins.jetbrains.com`, unpacking it into the client's `plugins\` folder. If `build.txt` is missing, the client folder hasn't been initialized yet — open a Remote Project from Gateway once, then re-run. After Gateway installs finish, **close and re-open the Gateway Client** for it to pick up the new plugins. --- ## Troubleshooting **`code` not on PATH.** See the VS Code installer details section above. **PowerShell refuses to run the script.** Each `.ps1` already sets `RemoteSigned` for the current process only. If your environment blocks that too, invoke explicitly: ```powershell powershell -ExecutionPolicy Bypass -File .\install.ps1 ``` **`installPlugins` reports a plugin is already installed.** Harmless — it's a no-op. Both scripts treat it as success. **"Only one instance of IDEA can be run at a time."** The IDE is currently open and holds the config-dir lock. Both JetBrains installers run a preflight check before installing: if a target IDE looks running, they prompt you to close it and press Enter to retry. If a process slips past the preflight, the install loop short-circuits with the same hint instead of repeating the error per plugin. **No JetBrains IDEs detected.** Install one via the [JetBrains Toolbox](https://www.jetbrains.com/toolbox-app/) (which sets up the standard paths the script scans), or install standalone — both layouts are supported. **WSL2 picker is empty.** Verify the Windows username is resolved: in WSL run `cmd.exe /c 'echo %USERNAME%'`. If that prints nothing, your `interop.appendWindowsPath` may be disabled; either re-enable it in `/etc/wsl.conf` or run `install-jetbrains.ps1` natively on Windows instead. **`Key Promoter X` install fails.** The xmlId contains spaces; if you're typing it manually elsewhere, quote it. The bundled scripts already do. --- ## Notes for re-running - Scripts are idempotent — already-installed extensions/plugins are skipped or upgraded in place. - Exit code is non-zero if any extension/plugin failed. - The JetBrains scripts ask every time; there's no flag to skip the picker by design.

<# .SYNOPSIS Install JetBrains plugins into locally installed IDEs (and into the JetBrains Gateway Client) on Windows. .DESCRIPTION Detects every JetBrains IDE under %LOCALAPPDATA%\Programs\* (standalone installs and Toolbox-managed installs) plus Toolbox shims under %LOCALAPPDATA%\JetBrains\Toolbox\scripts\*.cmd, and the most-recent JetBrains Gateway Client under %LOCALAPPDATA%\JetBrains\JetBrainsClient*. You multi-select IDE(s) and plugin(s) interactively. Standard IDEs get "installPlugins <id>..." invoked once with all selected plugins. The Gateway Client path is special: the bundled client has no installPlugins CLI, so plugins are downloaded directly from plugins.jetbrains.com and unpacked into the client's plugins folder (mirrors the user's plugins_gateway.ps1). .NOTES Process-scope ExecutionPolicy is set to RemoteSigned. No machine-wide change is persisted. If PowerShell still refuses to run the file: powershell -ExecutionPolicy Bypass -File .\install-jetbrains.ps1 #> [CmdletBinding()] param() # Loosen execution policy for THIS process only. try { $current = Get-ExecutionPolicy -Scope Process -ErrorAction Stop if ($current -in @('Restricted', 'AllSigned', 'Undefined')) { Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned -Force -ErrorAction Stop } } catch { Write-Verbose ("Could not adjust process execution policy: {0}" -f $_.Exception.Message) } $ErrorActionPreference = 'Stop' [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 # ------------------------------------------------------------------ # Canonical plugin catalog. Each entry: @{ Id; Label } # ------------------------------------------------------------------ $PluginCatalog = @( @{ Id = 'com.intellij.ml.llm'; Label = 'JetBrains AI Assistant' } @{ Id = 'izhangzhihao.rainbow.brackets'; Label = 'Rainbow Brackets' } @{ Id = 'IdeaVIM'; Label = 'IdeaVim' } @{ Id = 'org.sonarlint.idea'; Label = 'SonarQube for IDE (SonarLint)' } @{ Id = 'Key Promoter X'; Label = 'Key Promoter X' } @{ Id = 'net.ashald.envfile'; Label = 'EnvFile' } @{ Id = 'org.intellij.qodana'; Label = 'Qodana' } ) $KnownLauncherStems = @( 'idea64', 'pycharm64', 'webstorm64', 'goland64', 'rubymine64', 'clion64', 'phpstorm64', 'datagrip64', 'rustrover64', 'rider64', 'studio64', 'fleet' ) function Get-PrettyLabel { param([string]$Stem) switch -Regex ($Stem) { '^idea' { return 'IntelliJ IDEA' } '^pycharm' { return 'PyCharm' } '^webstorm' { return 'WebStorm' } '^goland' { return 'GoLand' } '^rubymine' { return 'RubyMine' } '^clion' { return 'CLion' } '^phpstorm' { return 'PhpStorm' } '^datagrip' { return 'DataGrip' } '^rustrover' { return 'RustRover' } '^rider' { return 'Rider' } '^studio' { return 'Android Studio' } '^fleet' { return 'Fleet' } default { return $Stem } } } # ------------------------------------------------------------------ # IDE candidate scan # Each candidate: PSCustomObject @{ Type; Launcher; Label; Path; Client } # Type: 'Ide' (run launcher installPlugins ...) # | 'WinCmd' (run .cmd shim via cmd.exe) # | 'Gateway' (download-and-unzip flow into $Client\plugins) # ------------------------------------------------------------------ $Candidates = New-Object System.Collections.Generic.List[object] # 1) Standalone & Toolbox-app installs under %LOCALAPPDATA%\Programs\*\bin\*.exe $programs = Join-Path $env:LOCALAPPDATA 'Programs' if (Test-Path $programs) { Get-ChildItem -Path $programs -Directory -ErrorAction SilentlyContinue | ForEach-Object { $binDir = Join-Path $_.FullName 'bin' if (-not (Test-Path $binDir)) { return } Get-ChildItem -Path $binDir -Filter '*.exe' -File -ErrorAction SilentlyContinue | ForEach-Object { $stem = [System.IO.Path]::GetFileNameWithoutExtension($_.Name) if ($KnownLauncherStems -notcontains $stem) { return } $Candidates.Add([pscustomobject]@{ Type = 'Ide' Launcher = $_.FullName Label = ("{0} ({1})" -f (Get-PrettyLabel $stem), $_.FullName) Path = $_.FullName Client = $null }) } } } # 2) Toolbox .cmd shims $tbScripts = Join-Path $env:LOCALAPPDATA 'JetBrains\Toolbox\scripts' if (Test-Path $tbScripts) { Get-ChildItem -Path $tbScripts -Filter '*.cmd' -File -ErrorAction SilentlyContinue | ForEach-Object { $stem = [System.IO.Path]::GetFileNameWithoutExtension($_.Name) # Toolbox shims keep names like "idea.cmd", "rider.cmd" — strip trailing 64 etc. $Candidates.Add([pscustomobject]@{ Type = 'WinCmd' Launcher = $_.FullName Label = ("{0} ({1})" -f (Get-PrettyLabel $stem), $_.FullName) Path = $_.FullName Client = $null }) } } # 3) JetBrains Gateway Client — pick the most-recently-modified one if any. $jbRoot = Join-Path $env:LOCALAPPDATA 'JetBrains' if (Test-Path $jbRoot) { $client = Get-ChildItem -Path $jbRoot -Directory -Filter 'JetBrainsClient*' -ErrorAction SilentlyContinue | Sort-Object LastWriteTime -Descending | Select-Object -First 1 if ($client) { $Candidates.Add([pscustomobject]@{ Type = 'Gateway' Launcher = $client.FullName Label = ("JetBrains Gateway Client ({0})" -f $client.FullName) Path = $client.FullName Client = $client.FullName }) } } if ($Candidates.Count -eq 0) { Write-Host "" Write-Host "No JetBrains IDEs or Gateway clients found." -ForegroundColor Red Write-Host "Install one via the JetBrains Toolbox, then re-run." -ForegroundColor Yellow exit 1 } # ------------------------------------------------------------------ # Multi-select picker — prefer Out-GridView when available. # ------------------------------------------------------------------ function Select-Multi { param( [Parameter(Mandatory)] [string]$Title, [Parameter(Mandatory)] [array]$Items, [Parameter(Mandatory)] [string]$Property ) $hasOgv = $false try { $cmd = Get-Command Out-GridView -ErrorAction Stop if ($cmd) { $hasOgv = $true } } catch { $hasOgv = $false } if ($hasOgv) { $chosen = $Items | Out-GridView -Title $Title -OutputMode Multiple return ,@($chosen) } # Numbered-prompt fallback. Write-Host "" Write-Host $Title -ForegroundColor Cyan for ($i = 0; $i -lt $Items.Count; $i++) { Write-Host (" {0,2}) {1}" -f ($i + 1), $Items[$i].$Property) } while ($true) { $raw = Read-Host "Select (e.g. 1,3,5 or a for all)" if ([string]::IsNullOrWhiteSpace($raw)) { Write-Host " please enter at least one number, or 'a'." -ForegroundColor Yellow continue } if ($raw.Trim().ToLower() -eq 'a') { return ,@($Items) } $idxs = $raw -split ',' | ForEach-Object { $_.Trim() } | Where-Object { $_ -ne '' } $bad = $false $sel = @() foreach ($t in $idxs) { if ($t -notmatch '^[0-9]+$') { $bad = $true; break } $n = [int]$t if ($n -lt 1 -or $n -gt $Items.Count) { $bad = $true; break } $sel += $Items[$n - 1] } if ($bad -or $sel.Count -eq 0) { Write-Host " invalid input; try again." -ForegroundColor Yellow continue } return ,@($sel) } } Write-Host ("Detected {0} JetBrains target(s)." -f $Candidates.Count) -ForegroundColor Green $selectedIdes = Select-Multi -Title "Pick IDE(s)" -Items $Candidates -Property 'Label' if ($selectedIdes.Count -eq 0) { Write-Host "No IDEs selected; exiting." -ForegroundColor Red exit 1 } $selectedPlugins = Select-Multi -Title "Pick plugin(s)" -Items $PluginCatalog -Property 'Label' if ($selectedPlugins.Count -eq 0) { Write-Host "No plugins selected; exiting." -ForegroundColor Red exit 1 } # ------------------------------------------------------------------ # Running-IDE preflight # installPlugins refuses to run while the IDE GUI holds the config-dir lock # ("Only one instance of IDEA can be run at a time."). Best-effort detection # via Get-Process. Gateway Client type doesn't need this (no CLI invoked). # ------------------------------------------------------------------ function Test-IdeRunning { param([Parameter(Mandatory)] [psobject]$Ide) if ($Ide.Type -eq 'Gateway') { return $false } # For standalone IDE launchers the process name is the exe basename. # For Toolbox .cmd shims, the spawned process is e.g. idea64 -> use prefix. $stem = [System.IO.Path]::GetFileNameWithoutExtension($Ide.Launcher) $patterns = @($stem) if ($stem -notmatch '64$') { $patterns += ($stem + '64') } foreach ($pat in $patterns) { if (Get-Process -Name $pat -ErrorAction SilentlyContinue) { return $true } } return $false } while ($true) { $running = @($selectedIdes | Where-Object { Test-IdeRunning $_ }) if ($running.Count -eq 0) { break } Write-Host "" Write-Host "The following IDE(s) appear to be running — installPlugins needs them closed:" -ForegroundColor Yellow foreach ($r in $running) { Write-Host (" - {0}" -f $r.Label) -ForegroundColor Yellow } Write-Host "" Read-Host "Close them, then press Enter to retry (Ctrl+C to abort)" | Out-Null } # ------------------------------------------------------------------ # Install loop # ------------------------------------------------------------------ $installed = 0 $failed = 0 $failedList = @() Write-Host "" Write-Host ("Installing {0} plugin(s) into {1} IDE(s)..." -f $selectedPlugins.Count, $selectedIdes.Count) -ForegroundColor Cyan Write-Host "" foreach ($ide in $selectedIdes) { Write-Host (">>> {0}" -f $ide.Label) switch ($ide.Type) { # ---- standard IDE launcher ---- 'Ide' { $args = @('installPlugins') + ($selectedPlugins | ForEach-Object { $_.Id }) try { $output = & $ide.Launcher @args 2>&1 if ($LASTEXITCODE -eq 0) { Write-Host (" all {0} plugin(s) ok" -f $selectedPlugins.Count) -ForegroundColor Green $installed += $selectedPlugins.Count } else { $joined = ($output | Out-String) if ($joined -match 'Only one instance') { Write-Host " IDE is running SKIPPED" -ForegroundColor Yellow Write-Host " Close the IDE and re-run the script to finish." -ForegroundColor DarkYellow } else { Write-Host (" installPlugins exited {0} FAILED" -f $LASTEXITCODE) -ForegroundColor Red $output | ForEach-Object { Write-Host " $_" -ForegroundColor DarkRed } } $failed += $selectedPlugins.Count foreach ($p in $selectedPlugins) { $failedList += ("{0} :: {1}" -f $ide.Label, $p.Id) } } } catch { Write-Host (" launcher invocation threw FAILED") -ForegroundColor Red $failed += $selectedPlugins.Count foreach ($p in $selectedPlugins) { $failedList += ("{0} :: {1}" -f $ide.Label, $p.Id) } Write-Host (" {0}" -f $_.Exception.Message) -ForegroundColor DarkRed } } # ---- Toolbox .cmd shim ---- 'WinCmd' { $idArgs = ($selectedPlugins | ForEach-Object { '"{0}"' -f $_.Id }) -join ' ' try { $output = cmd.exe /c "`"$($ide.Launcher)`" installPlugins $idArgs" 2>&1 if ($LASTEXITCODE -eq 0) { Write-Host (" all {0} plugin(s) ok" -f $selectedPlugins.Count) -ForegroundColor Green $installed += $selectedPlugins.Count } else { $joined = ($output | Out-String) if ($joined -match 'Only one instance') { Write-Host " IDE is running SKIPPED" -ForegroundColor Yellow Write-Host " Close the IDE and re-run the script to finish." -ForegroundColor DarkYellow } else { Write-Host (" installPlugins exited {0} FAILED" -f $LASTEXITCODE) -ForegroundColor Red $output | ForEach-Object { Write-Host " $_" -ForegroundColor DarkRed } } $failed += $selectedPlugins.Count foreach ($p in $selectedPlugins) { $failedList += ("{0} :: {1}" -f $ide.Label, $p.Id) } } } catch { Write-Host (" cmd.exe invocation threw FAILED") -ForegroundColor Red $failed += $selectedPlugins.Count foreach ($p in $selectedPlugins) { $failedList += ("{0} :: {1}" -f $ide.Label, $p.Id) } Write-Host (" {0}" -f $_.Exception.Message) -ForegroundColor DarkRed } } # ---- Gateway Client ---- 'Gateway' { $client = $ide.Client $buildFile = Join-Path $client 'build.txt' if (-not (Test-Path $buildFile)) { Write-Host " build.txt missing under client; cannot determine build id SKIPPED" -ForegroundColor Yellow Write-Host " (open a Remote Project once to populate the client folder)" -ForegroundColor DarkYellow $failed += $selectedPlugins.Count foreach ($p in $selectedPlugins) { $failedList += ("{0} :: {1}" -f $ide.Label, $p.Id) } continue } $buildId = (Get-Content $buildFile -Raw -ErrorAction Stop).Trim() $pluginDir = Join-Path $client 'plugins' if (-not (Test-Path $pluginDir)) { New-Item -ItemType Directory -Path $pluginDir | Out-Null } $ua = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36" foreach ($p in $selectedPlugins) { Write-Host -NoNewline (" {0,-34} " -f $p.Id) $encoded = [uri]::EscapeDataString($p.Id) $url = "https://plugins.jetbrains.com/pluginManager/?action=download&id=$encoded&build=$buildId" $tmp = Join-Path $env:TEMP ("jb-" + [guid]::NewGuid().ToString() + ".bin") try { Invoke-WebRequest -Uri $url -OutFile $tmp -UserAgent $ua -ErrorAction Stop -MaximumRedirection 5 $bytes = [System.IO.File]::ReadAllBytes($tmp) | Select-Object -First 2 if ($bytes.Count -ge 2 -and $bytes[0] -eq 0x50 -and $bytes[1] -eq 0x4B) { Expand-Archive -Path $tmp -DestinationPath $pluginDir -Force -ErrorAction Stop Write-Host "ok (zip)" -ForegroundColor Green } else { $jarName = Join-Path $pluginDir ($p.Id -replace '[^A-Za-z0-9._-]', '_') + '.jar' Move-Item -Path $tmp -Destination $jarName -Force Write-Host "ok (jar)" -ForegroundColor Green } $installed++ } catch { Write-Host "FAILED" -ForegroundColor Red Write-Host (" {0}" -f $_.Exception.Message) -ForegroundColor DarkRed $failed++ $failedList += ("{0} :: {1}" -f $ide.Label, $p.Id) } finally { if (Test-Path $tmp) { Remove-Item $tmp -Force -ErrorAction SilentlyContinue } } } Write-Host " Reopen the Gateway Client to load the new plugins." -ForegroundColor Yellow } } Write-Host "" } Write-Host ("Done. Installed: {0}, Failed: {1}" -f $installed, $failed) if ($failed -gt 0) { Write-Host "Failed:" -ForegroundColor Red foreach ($f in $failedList) { Write-Host (" - {0}" -f $f) -ForegroundColor Red } exit 1 }

#!/usr/bin/env bash # # JetBrains IDE plugin installer for macOS, Linux (Ubuntu Desktop) and WSL2. # # Detects every locally installed JetBrains IDE (Toolbox + standalone) and, # on Linux, any JetBrains Gateway remote-dev-server.sh distributions. Lets # you multi-select IDE(s) and plugin(s) interactively, then installs each # plugin into each selected IDE. # # Picker UX: # - Uses fzf with --multi when fzf is on PATH (TAB to toggle, Enter to confirm). # - Otherwise prints a numbered list and accepts comma-separated indexes # (e.g. "1,3,5") or "a" for all. # # Usage: # ./install-jetbrains.sh # interactive # ./install-jetbrains.sh --help set -euo pipefail IFS=$'\n\t' # ------------------------------------------------------------------ # Canonical marketplace plugin list (xmlId | display label). # Both columns separated by a literal pipe; the label is for the picker. # ------------------------------------------------------------------ readonly PLUGIN_CATALOG=( "com.intellij.ml.llm|JetBrains AI Assistant" "izhangzhihao.rainbow.brackets|Rainbow Brackets" "IdeaVIM|IdeaVim" "org.sonarlint.idea|SonarQube for IDE (SonarLint)" "Key Promoter X|Key Promoter X" "net.ashald.envfile|EnvFile" "org.intellij.qodana|Qodana" ) # Known JetBrains IDE launcher basenames (Toolbox shims + Linux .sh names). readonly KNOWN_IDE_NAMES=( idea idea.sh pycharm pycharm.sh webstorm webstorm.sh goland goland.sh rubymine rubymine.sh clion clion.sh phpstorm phpstorm.sh datagrip datagrip.sh rustrover rustrover.sh rider rider.sh studio studio.sh fleet ) usage() { cat <<EOF Usage: $(basename "$0") Interactive JetBrains IDE plugin installer for macOS, Linux and WSL2. The script: 1. Detects your OS (macOS / Linux / WSL2) 2. Scans for installed JetBrains IDEs (Toolbox + standalone) and any local remote-dev-server.sh distributions 3. Lets you multi-select IDE(s) and plugin(s) 4. Runs each launcher's "installPlugins" command for every selected plugin Use \`brew install fzf\` (or your distro's package manager) for a nicer picker. EOF } while [[ $# -gt 0 ]]; do case "$1" in -h|--help) usage; exit 0 ;; *) echo "Error: unknown argument '$1'." >&2; usage >&2; exit 2 ;; esac done # ------------------------------------------------------------------ # OS detection # ------------------------------------------------------------------ OS_KIND="" case "$(uname -s)" in Darwin) OS_KIND=macos ;; Linux) if grep -qi microsoft /proc/version 2>/dev/null; then OS_KIND=wsl2 else OS_KIND=linux fi ;; *) echo "Error: unsupported OS '$(uname -s)'. Use install-jetbrains.ps1 on Windows." >&2 exit 1 ;; esac # ------------------------------------------------------------------ # Helpers # ------------------------------------------------------------------ # is_known_ide_name <basename> -> 0 if it matches a known JetBrains launcher. is_known_ide_name() { local n="$1" local k for k in "${KNOWN_IDE_NAMES[@]}"; do [[ "$n" == "$k" ]] && return 0 done return 1 } # pretty_from_path /path/to/idea.sh -> "IntelliJ IDEA (~/.local/share/.../idea.sh)" # Builds a short, readable label for the picker. pretty_label() { local path="$1" base base="$(basename "$path")" base="${base%.sh}" base="${base%.cmd}" base="${base%.exe}" case "$base" in idea|idea64) printf 'IntelliJ IDEA' ;; pycharm|pycharm64) printf 'PyCharm' ;; webstorm|webstorm64) printf 'WebStorm' ;; goland|goland64) printf 'GoLand' ;; rubymine|rubymine64) printf 'RubyMine' ;; clion|clion64) printf 'CLion' ;; phpstorm|phpstorm64) printf 'PhpStorm' ;; datagrip|datagrip64) printf 'DataGrip' ;; rustrover|rustrover64) printf 'RustRover' ;; rider|rider64) printf 'Rider' ;; studio|studio64) printf 'Android Studio' ;; fleet) printf 'Fleet' ;; *) printf '%s' "$base" ;; esac printf ' (%s)' "$path" } # Translate a Linux/WSL home into the Windows-side user dir under /mnt/c. win_user_dir() { local winuser winuser="$(cmd.exe /c 'echo %USERNAME%' 2>/dev/null | tr -d '\r\n' || true)" [[ -z "$winuser" ]] && winuser="$USER" printf '/mnt/c/Users/%s' "$winuser" } # ------------------------------------------------------------------ # IDE candidate scan # Each candidate is recorded as a single line: # <type>|<launcher>|<label> # where <type> is one of: # ide -> run "<launcher> installPlugins <id>..." # wincmd -> run "cmd.exe /c <launcher> installPlugins <id>..." # remotedev -> remote-dev-server.sh installPlugins ... # ------------------------------------------------------------------ declare -a CANDIDATES=() add_candidate() { local type="$1" launcher="$2" CANDIDATES+=("${type}|${launcher}|$(pretty_label "$launcher")") } scan_macos() { local d="$HOME/Library/Application Support/JetBrains/Toolbox/scripts" if [[ -d "$d" ]]; then local f while IFS= read -r -d '' f; do local base base="$(basename "$f")" is_known_ide_name "$base" || continue [[ -x "$f" ]] && add_candidate ide "$f" done < <(find "$d" -maxdepth 1 -type f -print0 2>/dev/null) fi local app bin for app in /Applications/*.app; do [[ -d "$app/Contents/MacOS" ]] || continue [[ "$(basename "$app")" =~ ^(IntelliJ|PyCharm|WebStorm|GoLand|RubyMine|CLion|PhpStorm|DataGrip|RustRover|Rider|Android\ Studio|Fleet) ]] || continue for bin in "$app"/Contents/MacOS/*; do [[ -x "$bin" ]] || continue local b b="$(basename "$bin")" is_known_ide_name "$b" || continue add_candidate ide "$bin" done done } scan_linux() { local apps="$HOME/.local/share/JetBrains/Toolbox/apps" if [[ -d "$apps" ]]; then local f while IFS= read -r -d '' f; do local b b="$(basename "$f")" is_known_ide_name "$b" || continue [[ -x "$f" ]] && add_candidate ide "$f" done < <(find "$apps" -maxdepth 3 -type f -name '*.sh' -print0 2>/dev/null) fi # /opt/<ide>/bin/<ide>.sh — common for .deb / snap / tarball installs. local opt for opt in /opt/*/bin/*.sh; do [[ -x "$opt" ]] || continue local b b="$(basename "$opt")" is_known_ide_name "$b" || continue add_candidate ide "$opt" done # Remote-dev-server distributions (Orbstack/Gateway). local rd while IFS= read -r -d '' rd; do add_candidate remotedev "$rd" done < <(find "$HOME/.cache/JetBrains/RemoteDev/dist" -maxdepth 3 -type f -name 'remote-dev-server.sh' -print0 2>/dev/null) } scan_wsl2() { local winhome winhome="$(win_user_dir)" [[ -d "$winhome" ]] || return 0 # Standalone installs under AppData\Local\Programs\<IDE>\bin\*.exe local exe b while IFS= read -r -d '' exe; do b="$(basename "$exe")" case "$b" in idea64.exe|pycharm64.exe|webstorm64.exe|goland64.exe|rubymine64.exe|\ clion64.exe|phpstorm64.exe|datagrip64.exe|rustrover64.exe|rider64.exe|\ studio64.exe|fleet.exe) add_candidate ide "$exe" ;; esac done < <(find "$winhome/AppData/Local/Programs" -maxdepth 4 -type f -name '*.exe' -print0 2>/dev/null) # Toolbox shell shims (.cmd) — invoke via cmd.exe. local scripts="$winhome/AppData/Local/JetBrains/Toolbox/scripts" if [[ -d "$scripts" ]]; then local f while IFS= read -r -d '' f; do b="$(basename "${f%.cmd}")" is_known_ide_name "$b" || continue add_candidate wincmd "$f" done < <(find "$scripts" -maxdepth 1 -type f -name '*.cmd' -print0 2>/dev/null) fi # Local Linux-side remote-dev-server.sh (still useful inside WSL2). local rd while IFS= read -r -d '' rd; do add_candidate remotedev "$rd" done < <(find "$HOME/.cache/JetBrains/RemoteDev/dist" -maxdepth 3 -type f -name 'remote-dev-server.sh' -print0 2>/dev/null) } case "$OS_KIND" in macos) scan_macos ;; linux) scan_linux ;; wsl2) scan_wsl2 ;; esac if [[ ${#CANDIDATES[@]} -eq 0 ]]; then echo "No JetBrains IDEs detected on this system." >&2 echo "Install one via the JetBrains Toolbox, then re-run." >&2 exit 1 fi # ------------------------------------------------------------------ # Multi-select picker # Reads newline-separated options on stdin, prints selected lines on stdout. # ------------------------------------------------------------------ pick_multi() { local prompt="$1" header="$2" if command -v fzf >/dev/null 2>&1; then fzf --multi --reverse --prompt="$prompt " --header="$header" return fi # Fallback: numbered list + comma-input. local -a items=() local line while IFS= read -r line; do items+=("$line"); done local total=${#items[@]} i while :; do { echo "$header" for (( i=0; i<total; i++ )); do printf ' %2d) %s\n' "$((i+1))" "${items[i]}" done printf '%s' "$prompt (e.g. 1,3,5 or a for all): " } >&2 local input if ! IFS= read -r input </dev/tty; then echo "no tty available; install fzf or run interactively" >&2 return 1 fi if [[ "$input" == "a" || "$input" == "A" ]]; then printf '%s\n' "${items[@]}" return fi [[ -z "$input" ]] && { echo " please enter at least one number, or 'a'." >&2; continue; } local -a picked=() bad=0 local tok IFS=',' read -r -a toks <<<"$input" for tok in "${toks[@]}"; do tok="${tok// /}" [[ -z "$tok" ]] && continue if [[ ! "$tok" =~ ^[0-9]+$ ]]; then bad=1; break; fi if (( tok < 1 || tok > total )); then bad=1; break; fi picked+=("${items[tok-1]}") done if (( bad )); then echo " invalid input; try again." >&2 continue fi if (( ${#picked[@]} == 0 )); then echo " no valid selections; try again." >&2 continue fi printf '%s\n' "${picked[@]}" return done } # ------------------------------------------------------------------ # IDE picker # ------------------------------------------------------------------ declare -a ide_lines=() for c in "${CANDIDATES[@]}"; do # human-readable picker line: just the third field ide_lines+=("${c#*|*|}") done # Map label -> (type, launcher) so we can recover after picking. declare -A label_type label_launcher for c in "${CANDIDATES[@]}"; do IFS='|' read -r t l lab <<<"$c" label_type[$lab]="$t" label_launcher[$lab]="$l" done echo "Detected ${#CANDIDATES[@]} JetBrains target(s)." mapfile -t SELECTED_IDES < <( printf '%s\n' "${ide_lines[@]}" | pick_multi "IDEs>" "Pick IDE(s) — TAB to toggle (fzf) or comma indexes" ) if (( ${#SELECTED_IDES[@]} == 0 )); then echo "No IDEs selected; exiting." >&2 exit 1 fi # ------------------------------------------------------------------ # Plugin picker # ------------------------------------------------------------------ declare -a plugin_lines=() declare -A label_to_id for entry in "${PLUGIN_CATALOG[@]}"; do IFS='|' read -r pid plabel <<<"$entry" line="$(printf '%-32s %s' "$plabel" "$pid")" plugin_lines+=("$line") label_to_id[$line]="$pid" done mapfile -t SELECTED_PLUGIN_LINES < <( printf '%s\n' "${plugin_lines[@]}" | pick_multi "Plugins>" "Pick plugin(s) — TAB to toggle (fzf) or comma indexes" ) if (( ${#SELECTED_PLUGIN_LINES[@]} == 0 )); then echo "No plugins selected; exiting." >&2 exit 1 fi declare -a SELECTED_PLUGIN_IDS=() for line in "${SELECTED_PLUGIN_LINES[@]}"; do SELECTED_PLUGIN_IDS+=("${label_to_id[$line]}") done # ------------------------------------------------------------------ # Running-IDE preflight # JetBrains' `installPlugins` refuses to run while the IDE GUI is open # ("Only one instance of IDEA can be run at a time."). We do a best-effort # pgrep against the IDE app directory so the user can close them upfront # instead of seeing N identical errors during the install loop. # ------------------------------------------------------------------ ide_is_running() { local launcher="$1" type="$2" # remote-dev-server.sh spawns short-lived workers; WSL2->Windows lookups # would need tasklist.exe — skip in both cases. case "$type" in remotedev|wincmd) return 1 ;; esac case "$launcher" in */Toolbox/apps/*) # /.../Toolbox/apps/<ide-dir>/[ch-N/<ver>/]bin/idea.sh -> match "<ide-dir>" local rest="${launcher#*/Toolbox/apps/}" local ide_dir="${rest%%/*}" [[ -n "$ide_dir" ]] && pgrep -f -- "/Toolbox/apps/${ide_dir}/" >/dev/null 2>&1 ;; */Applications/*.app/*) local app_path="${launcher%/Contents/MacOS/*}" pgrep -f -- "${app_path}/Contents/" >/dev/null 2>&1 ;; *) local b b="$(basename "$launcher")" b="${b%.sh}" pgrep -fi -- "$b" >/dev/null 2>&1 ;; esac } while :; do declare -a _running=() for ide_label in "${SELECTED_IDES[@]}"; do if ide_is_running "${label_launcher[$ide_label]}" "${label_type[$ide_label]}"; then _running+=("$ide_label") fi done (( ${#_running[@]} == 0 )) && break { echo echo "The following IDE(s) appear to be running — installPlugins needs them closed:" for r in "${_running[@]}"; do echo " - $r" done echo printf 'Close them, then press Enter to retry (or Ctrl+C to abort): ' } >&2 if ! IFS= read -r _ </dev/tty; then echo "no tty; aborting" >&2 exit 1 fi done # ------------------------------------------------------------------ # Install loop # ------------------------------------------------------------------ LOG_FILE="$(mktemp -t jb-install.XXXXXX)" trap 'rm -f "$LOG_FILE"' EXIT installed=0 failed=0 declare -a FAILED_LIST=() echo echo "Installing ${#SELECTED_PLUGIN_IDS[@]} plugin(s) into ${#SELECTED_IDES[@]} IDE(s)..." echo handle_single_instance_abort() { local ide_label="$1" current_pid="$2" shift 2 echo echo " ! '${ide_label}' is still running. Skipping remaining plugins for this IDE." >&2 echo " ! Close the IDE and re-run the script to finish." >&2 # Mark current and remaining-for-this-IDE plugins as failed. local mark_from=0 p for p in "${SELECTED_PLUGIN_IDS[@]}"; do if (( mark_from )) || [[ "$p" == "$current_pid" ]]; then mark_from=1 failed=$((failed + 1)) FAILED_LIST+=("${ide_label} :: ${p} (IDE running — close it and re-run)") fi done } for ide_label in "${SELECTED_IDES[@]}"; do itype="${label_type[$ide_label]}" launcher="${label_launcher[$ide_label]}" echo ">>> $ide_label" ide_aborted=0 for pid in "${SELECTED_PLUGIN_IDS[@]}"; do (( ide_aborted )) && break printf ' %-34s ' "$pid" rc=0 case "$itype" in ide|remotedev) "$launcher" installPlugins "$pid" >"$LOG_FILE" 2>&1 || rc=$? ;; wincmd) cmd.exe /c "$launcher" installPlugins "$pid" >"$LOG_FILE" 2>&1 || rc=$? ;; esac if (( rc == 0 )); then echo "ok" installed=$((installed + 1)) elif grep -q "Only one instance" "$LOG_FILE" 2>/dev/null; then echo "SKIPPED" handle_single_instance_abort "$ide_label" "$pid" ide_aborted=1 else echo "FAILED" failed=$((failed + 1)) FAILED_LIST+=("${ide_label} :: ${pid}") sed 's/^/ /' "$LOG_FILE" >&2 || true fi done echo done echo "Done. Installed: ${installed}, Failed: ${failed}" if (( failed > 0 )); then echo "Failed:" >&2 for f in "${FAILED_LIST[@]}"; do echo " - $f" >&2 done exit 1 fi

<# .SYNOPSIS Install a curated list of VS Code extensions on Windows. .DESCRIPTION Installs the bundled extension list using the VS Code 'code' CLI. Sets the current process's ExecutionPolicy to RemoteSigned (no machine-wide change) so the script can run on a default Windows configuration. .PARAMETER ProfileName Optional VS Code profile name. If supplied, extensions are installed into that profile. VS Code creates the profile if it doesn't already exist. Quote names that contain spaces. .EXAMPLE PS> .\install.ps1 .EXAMPLE PS> .\install.ps1 -ProfileName "WorkSetup" .NOTES If PowerShell refuses to run the file, invoke it as: powershell -ExecutionPolicy Bypass -File .\install.ps1 #> [CmdletBinding()] param( [Parameter(Mandatory = $false, Position = 0)] [string]$ProfileName = "" ) # Loosen execution policy for THIS process only (no persisted change). try { $current = Get-ExecutionPolicy -Scope Process -ErrorAction Stop if ($current -in @('Restricted', 'AllSigned', 'Undefined')) { Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned -Force -ErrorAction Stop } } catch { Write-Verbose ("Could not adjust process execution policy: {0}" -f $_.Exception.Message) } $ErrorActionPreference = 'Stop' $Extensions = @( 'docker.docker', 'github.github-vscode-theme', 'ms-vscode-remote.vscode-remote-extensionpack', 'pkief.material-icon-theme' ) $codeCmd = Get-Command code -ErrorAction SilentlyContinue if (-not $codeCmd) { Write-Host "" Write-Host "Error: the 'code' command is not on your PATH." -ForegroundColor Red Write-Host " Install VS Code from https://code.visualstudio.com/ and make sure" -ForegroundColor Yellow Write-Host ' "Add to PATH" was checked during setup, then re-open your terminal.' -ForegroundColor Yellow exit 1 } $extraArgs = @() if (-not [string]::IsNullOrWhiteSpace($ProfileName)) { $extraArgs += @('--profile', $ProfileName) } $header = "Installing $($Extensions.Count) extension(s)" if ($ProfileName) { $header += " into profile '$ProfileName'" } Write-Host ("{0}..." -f $header) -ForegroundColor Cyan Write-Host "" $installed = 0 $failed = 0 $failedList = @() foreach ($ext in $Extensions) { Write-Host -NoNewline (" -> {0,-55} " -f $ext) try { $output = & code @extraArgs --install-extension $ext --force 2>&1 if ($LASTEXITCODE -eq 0) { Write-Host "ok" -ForegroundColor Green $installed++ } else { Write-Host "FAILED" -ForegroundColor Red $failed++ $failedList += $ext $output | ForEach-Object { Write-Host " $_" -ForegroundColor DarkRed } } } catch { Write-Host "FAILED" -ForegroundColor Red $failed++ $failedList += $ext Write-Host (" {0}" -f $_.Exception.Message) -ForegroundColor DarkRed } } Write-Host "" Write-Host ("Done. Installed: {0}, Failed: {1}" -f $installed, $failed) if ($failed -gt 0) { Write-Host "Failed extensions:" -ForegroundColor Red foreach ($f in $failedList) { Write-Host (" - {0}" -f $f) -ForegroundColor Red } exit 1 }

#!/usr/bin/env bash # # VS Code extension installer for macOS and Linux (Ubuntu). # # Usage: # ./install.sh # install into the default profile # ./install.sh --profile "MyProfile" # install into a named profile # ./install.sh --help # # If --profile is provided and the profile does not exist, VS Code creates # it automatically. Quote names that contain spaces. set -euo pipefail IFS=$'\n\t' readonly EXTENSIONS=( "docker.docker" "github.github-vscode-theme" "ms-vscode-remote.vscode-remote-extensionpack" "pkief.material-icon-theme" ) PROFILE="" usage() { cat <<EOF Usage: $(basename "$0") [--profile "ProfileName"] Installs a curated list of VS Code extensions on macOS or Linux. Options: -p, --profile <name> Install into the named VS Code profile. VS Code creates the profile if it doesn't exist. -h, --help Show this help and exit. EOF } while [[ $# -gt 0 ]]; do case "$1" in -p|--profile) if [[ $# -lt 2 || -z "${2:-}" ]]; then echo "Error: --profile requires a non-empty value." >&2 exit 2 fi PROFILE="$2" shift 2 ;; -h|--help) usage exit 0 ;; *) echo "Error: unknown argument '$1'." >&2 usage >&2 exit 2 ;; esac done OS="$(uname -s)" case "$OS" in Darwin|Linux) ;; *) echo "Error: unsupported OS '$OS'. Use install.ps1 on Windows." >&2 exit 1 ;; esac if ! command -v code >/dev/null 2>&1; then cat >&2 <<'EOF' Error: the 'code' command is not on your PATH. macOS: open VS Code, press Cmd+Shift+P, run "Shell Command: Install 'code' command in PATH". Linux: install VS Code from https://code.visualstudio.com/ (or: sudo snap install --classic code), then reopen your shell. EOF exit 1 fi declare -a CODE_ARGS=() if [[ -n "$PROFILE" ]]; then CODE_ARGS+=("--profile" "$PROFILE") fi LOG_FILE="$(mktemp -t vscode-install.XXXXXX)" trap 'rm -f "$LOG_FILE"' EXIT header="Installing ${#EXTENSIONS[@]} extension(s)" [[ -n "$PROFILE" ]] && header+=" into profile '$PROFILE'" echo "$header..." echo installed=0 failed=0 declare -a FAILED_LIST=() for ext in "${EXTENSIONS[@]}"; do printf ' -> %-55s ' "$ext" if code "${CODE_ARGS[@]}" --install-extension "$ext" --force >"$LOG_FILE" 2>&1; then echo "ok" installed=$((installed + 1)) else echo "FAILED" failed=$((failed + 1)) FAILED_LIST+=("$ext") sed 's/^/ /' "$LOG_FILE" >&2 || true fi done echo echo "Done. Installed: ${installed}, Failed: ${failed}" if (( failed > 0 )); then echo "Failed extensions:" >&2 for f in "${FAILED_LIST[@]}"; do echo " - $f" >&2 done exit 1 fi