# VS Code + JetBrains Extension Managers A bundle of cross-platform scripts for editor extensions and plugins, one command per platform. The JetBrains scripts install and uninstall plugins; the VS Code scripts install extensions. | 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 # 1. macOS / Ubuntu (Install to default profile from a LOCAL .vscode/extensions.json) bash <(curl -sSL https://opengist.resetrix.work/weehong/b2a7c0a2ae6d40e8a14f8d85964a9186/raw/HEAD/install.sh) # 2. Install remote recommendation JSON to the default profile bash <(curl -sSL https://opengist.resetrix.work/weehong/b2a7c0a2ae6d40e8a14f8d85964a9186/raw/HEAD/install.sh) -f "https://opengist.resetrix.work/weehong/b2a7c0a2ae6d40e8a14f8d85964a9186/raw/HEAD/typescript_react_recommendation.json" # 3. Install TypeScript and React remote recommendation JSON to a specific named profile bash <(curl -sSL https://opengist.resetrix.work/weehong/b2a7c0a2ae6d40e8a14f8d85964a9186/raw/HEAD/install.sh) -p "TypeScript" -f "https://opengist.resetrix.work/weehong/b2a7c0a2ae6d40e8a14f8d85964a9186/raw/HEAD/typescript_react_recommendation.json" # 4. Install Python remote recommendation JSON to a specific named profile bash <(curl -sSL https://opengist.resetrix.work/weehong/b2a7c0a2ae6d40e8a14f8d85964a9186/raw/HEAD/install.sh) -p "Python" -f "https://opengist.resetrix.work/weehong/b2a7c0a2ae6d40e8a14f8d85964a9186/raw/HEAD/python_recommendation.json" ``` ```powershell # Windows iwr -useb https://opengist.resetrix.work/weehong/b2a7c0a2ae6d40e8a14f8d85964a9186/raw/HEAD/install.ps1 | iex # named profile .\install.ps1 -ProfileName "WorkSetup" ``` ### JetBrains ```bash # macOS / Ubuntu / WSL2 — IDE, action, then plugin picker bash <(curl -sSL https://opengist.resetrix.work/weehong/b2a7c0a2ae6d40e8a14f8d85964a9186/raw/HEAD/install-jetbrains.sh) ``` ```powershell # Windows — IDE, action, then plugin picker iwr -useb https://opengist.resetrix.work/weehong/b2a7c0a2ae6d40e8a14f8d85964a9186/raw/HEAD/install-jetbrains.ps1 | iex ``` --- ## What's in the catalogs ### VS Code extensions - `docker.docker` - `github.github-vscode-theme` - `GitHub.vscode-github-actions` - `ms-azuretools.vscode-containers` - `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 the IDE picker first. 4. Ask whether to install or uninstall. 5. For install, show the curated catalog; for uninstall, show the user-installed plugins actually found in the selected IDEs. 6. Install the selected marketplace IDs or, after showing exact paths and asking for confirmation, remove the selected plugin files. JetBrains AI Assistant is identified by its marketplace ID, `com.intellij.ml.llm`, so uninstall works even though its on-disk directory is normally named `ml-llm`. ### 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 space-separated indexes (`1 3 5`), exclusions (`!2 !4`), or `a` for all. - **PowerShell:** uses `Out-GridView -OutputMode Multiple` when available; otherwise the same numbered/comma-input fallback. ### Uninstall behavior JetBrains launchers provide `installPlugins` but no matching uninstall command. The scripts therefore resolve the selected IDE's `dataDirectoryName` from `product-info.json`, inspect each user-installed plugin's `META-INF/plugin.xml`, and present those plugin names and IDs for selection. Before removal, the script prints every resolved IDE and path and requires confirmation. Only user-installed plugins are offered. Bundled plugins cannot be removed this way and must be disabled in the IDE. Restart the selected IDEs after uninstalling. ### 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 scripts run a preflight check before changing plugins: 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 for IDE, action, and plugin choices every time; there's no flag to skip the picker by design.

<!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <meta name="viewport" content="width=device-width, initial-scale=1"> <title>IdeaVim Cheatsheet</title> <style> @page { size: A4; margin: 14mm; } * { box-sizing: border-box; } body { margin: 0; color: #15171a; background: #ffffff; font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; font-size: 10.5px; line-height: 1.35; } header { margin-bottom: 14px; padding-bottom: 10px; border-bottom: 2px solid #15171a; } h1 { margin: 0 0 3px; font-size: 25px; line-height: 1.1; letter-spacing: 0; } .subtitle { margin: 0; color: #4d5662; font-size: 11px; } .grid { display: grid; grid-template-columns: 1fr 1fr; gap: 11px 14px; align-items: start; } section { break-inside: avoid; page-break-inside: avoid; } h2 { margin: 0 0 5px; padding: 5px 7px; color: #ffffff; background: #243447; border-radius: 4px; font-size: 11px; line-height: 1.2; letter-spacing: 0; } table { width: 100%; border-collapse: collapse; table-layout: fixed; border: 1px solid #d5dbe3; border-radius: 4px; overflow: hidden; } th, td { padding: 5px 6px; vertical-align: top; border-bottom: 1px solid #e5e9ef; } tr:last-child td { border-bottom: 0; } th { color: #4d5662; background: #f4f6f8; font-weight: 650; text-align: left; font-size: 9px; text-transform: uppercase; } th:first-child, td:first-child { width: 33%; } code { display: inline-block; padding: 1px 4px; color: #0f1720; background: #eef2f7; border: 1px solid #dce3ec; border-radius: 3px; font-family: "JetBrains Mono", "SFMono-Regular", Consolas, monospace; font-size: 9.5px; line-height: 1.25; white-space: nowrap; } .note { margin: 10px 0 0; padding: 7px 8px; color: #313942; background: #fff7e1; border: 1px solid #ead48a; border-radius: 4px; font-size: 10px; } .wide { grid-column: 1 / -1; } </style> </head> <body> <header> <h1>IdeaVim Cheatsheet</h1> <p class="subtitle">Leader key: <code>Space</code>. Example: <code>&lt;leader&gt;ff</code> means <code>Space f f</code>.</p> </header> <main class="grid"> <section> <h2>Navigation</h2> <table> <thead><tr><th>Key</th><th>Action</th></tr></thead> <tbody> <tr><td><code>gd</code></td><td>Go to declaration</td></tr> <tr><td><code>gi</code></td><td>Go to implementation</td></tr> <tr><td><code>gr</code></td><td>Find usages</td></tr> <tr><td><code>gb</code></td><td>Go back</td></tr> <tr><td><code>gB</code></td><td>Go forward</td></tr> </tbody> </table> </section> <section> <h2>Files And Search</h2> <table> <thead><tr><th>Key</th><th>Action</th></tr></thead> <tbody> <tr><td><code>Space ff</code></td><td>Go to file</td></tr> <tr><td><code>Space fs</code></td><td>Find in project</td></tr> <tr><td><code>Space fa</code></td><td>Go to IDE action</td></tr> <tr><td><code>Space fr</code></td><td>Recent files</td></tr> <tr><td><code>Space e</code></td><td>Select current file in project view</td></tr> </tbody> </table> </section> <section> <h2>Code Actions</h2> <table> <thead><tr><th>Key</th><th>Action</th></tr></thead> <tbody> <tr><td><code>Space ca</code></td><td>Show intention actions / quick fix</td></tr> <tr><td><code>Space cf</code></td><td>Reformat code</td></tr> <tr><td><code>Space co</code></td><td>Optimize imports</td></tr> <tr><td><code>Space R</code></td><td>Rename symbol</td></tr> </tbody> </table> </section> <section> <h2>Run And Debug</h2> <table> <thead><tr><th>Key</th><th>Action</th></tr></thead> <tbody> <tr><td><code>Space rr</code></td><td>Run</td></tr> <tr><td><code>Space dd</code></td><td>Debug</td></tr> <tr><td><code>Space db</code></td><td>Toggle breakpoint</td></tr> </tbody> </table> </section> <section> <h2>Tool Windows</h2> <table> <thead><tr><th>Key</th><th>Action</th></tr></thead> <tbody> <tr><td><code>Space tt</code></td><td>Open terminal</td></tr> <tr><td><code>Space hh</code></td><td>Hide all tool windows</td></tr> </tbody> </table> </section> <section> <h2>Completion</h2> <table> <thead><tr><th>Key</th><th>Action</th></tr></thead> <tbody> <tr><td><code>Tab</code></td><td>Next completion item</td></tr> <tr><td><code>Shift+Tab</code></td><td>Previous completion item</td></tr> </tbody> </table> </section> <section class="wide"> <h2>Surround</h2> <table> <thead><tr><th>Key</th><th>Example / Meaning</th></tr></thead> <tbody> <tr><td><code>cs"'</code></td><td>Change <code>"hello"</code> to <code>'hello'</code></td></tr> <tr><td><code>cs({</code></td><td>Change <code>(x)</code> to <code>{ x }</code></td></tr> <tr><td><code>ds"</code></td><td>Delete surrounding quotes from <code>"hello"</code></td></tr> <tr><td><code>ysiw"</code></td><td>Surround current word with quotes</td></tr> <tr><td><code>yss)</code></td><td>Surround the whole line with parentheses</td></tr> </tbody> </table> </section> <section> <h2>Text Objects</h2> <table> <thead><tr><th>Key</th><th>Action</th></tr></thead> <tbody> <tr><td><code>ciq</code></td><td>Change inside any quote</td></tr> <tr><td><code>caq</code></td><td>Change around any quote</td></tr> <tr><td><code>cib</code></td><td>Change inside any bracket</td></tr> <tr><td><code>cab</code></td><td>Change around any bracket</td></tr> <tr><td><code>diq</code></td><td>Delete inside any quote</td></tr> <tr><td><code>dib</code></td><td>Delete inside any bracket</td></tr> <tr><td><code>viq</code></td><td>Select inside any quote</td></tr> <tr><td><code>vib</code></td><td>Select inside any bracket</td></tr> </tbody> </table> </section> <section> <h2>Multi-Cursor</h2> <table> <thead><tr><th>Key</th><th>Action</th></tr></thead> <tbody> <tr><td><code>Ctrl+n</code></td><td>Select next occurrence of word</td></tr> <tr><td><code>g Ctrl+n</code></td><td>Select next occurrence, not whole word</td></tr> <tr><td><code>Alt+n</code></td><td>Select all occurrences in file</td></tr> <tr><td><code>Ctrl+x</code></td><td>Skip current occurrence</td></tr> <tr><td><code>Ctrl+p</code></td><td>Remove current occurrence</td></tr> </tbody> </table> </section> <section class="wide"> <h2>Reload Config</h2> <table> <thead><tr><th>Key / Command</th><th>Action</th></tr></thead> <tbody> <tr><td><code>Ctrl+Shift+O</code></td><td>Reload <code>~/.ideavimrc</code> from JetBrains</td></tr> <tr><td><code>:source ~/.ideavimrc</code></td><td>Reload <code>~/.ideavimrc</code> from Vim command mode</td></tr> </tbody> </table> <p class="note">EasyMotion requires the JetBrains IdeaVim-EasyMotion and AceJump IDE plugins.</p> </section> </main> </body> </html>

" .ideavimrc is a configuration file for IdeaVim plugin. It uses " the same commands as the original .vimrc configuration. " You can find a list of commands here: https://jb.gg/h38q75 " Find more examples here: https://jb.gg/share-ideavimrc " Source your .vimrc source ~/.vimrc "" -- Suggested options -- " Show a few lines of context around the cursor. Note that this makes the " text scroll if you mouse-click near the start or end of the window. set scrolloff=5 " Do incremental searching. set incsearch " Don't use Ex mode, use Q for formatting. map Q gq " --- Enable IdeaVim plugins https://jb.gg/ideavim-plugins " Highlight copied text Plug 'machakann/vim-highlightedyank' " Commentary plugin Plug 'tpope/vim-commentary' " Surround text objects and changes Plug 'tpope/vim-surround' " Better text objects around quotes, brackets, arguments, and separators Plug 'wellle/targets.vim' " Fast cursor jumps. Requires the IdeaVim-EasyMotion and AceJump IDE plugins. Plug 'easymotion/vim-easymotion' " Multi-cursor editing Plug 'terryma/vim-multiple-cursors' " --- Better IdeaVim / IDE integration --- set ideajoin set clipboard+=unnamedplus set ideamarks " --- Optional built-in IdeaVim extensions --- set mini-ai set youcompleteme " --- IDE navigation --- nmap gd <Action>(GotoDeclaration) nmap gi <Action>(GotoImplementation) nmap gr <Action>(FindUsages) nmap gb <Action>(Back) nmap gB <Action>(Forward) " --- Search / files / project --- nmap <leader>ff <Action>(GotoFile) nmap <leader>fs <Action>(FindInPath) nmap <leader>fa <Action>(GotoAction) nmap <leader>fr <Action>(RecentFiles) nmap <leader>e <Action>(SelectInProjectView) " --- Code actions --- nmap <leader>ca <Action>(ShowIntentionActions) nmap <leader>cf <Action>(ReformatCode) nmap <leader>co <Action>(OptimizeImports) nmap <leader>R <Action>(RenameElement) " --- Run / debug --- nmap <leader>rr <Action>(Run) nmap <leader>dd <Action>(Debug) nmap <leader>db <Action>(ToggleLineBreakpoint) " --- Tool windows --- nmap <leader>tt <Action>(ActivateTerminalToolWindow) nmap <leader>hh <Action>(HideAllWindows) "" -- Map IDE actions to IdeaVim -- https://jb.gg/abva4t "" Map \r to the Reformat Code action "map \r <Action>(ReformatCode) "" Map <leader>d to start debug "map <leader>d <Action>(Debug) "" Map \b to toggle the breakpoint on the current line "map \b <Action>(ToggleLineBreakpoint)

<# .SYNOPSIS Install or uninstall JetBrains plugins in locally installed IDEs (and in 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 select IDE(s), choose install or uninstall, and then select plugin(s). Standard IDEs get "installPlugins <id>..." invoked once with all selected plugins. Uninstall reads plugin IDs from the selected IDEs' user plugin directories and removes only the entries selected by the user. 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 try { Add-Type -AssemblyName System.IO.Compression.FileSystem -ErrorAction Stop } catch { Write-Verbose ("Could not preload ZIP support: {0}" -f $_.Exception.Message) } # ------------------------------------------------------------------ # 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) } } function Select-Action { while ($true) { Write-Host "" Write-Host "What do you want to do?" -ForegroundColor Cyan Write-Host " 1) Install plugins" Write-Host " 2) Uninstall plugins" $choice = Read-Host "Action (1 or 2)" switch ($choice.Trim().ToLower()) { { $_ -in @('1', 'i', 'install') } { return 'Install' } { $_ -in @('2', 'u', 'uninstall') } { return 'Uninstall' } default { Write-Host " invalid input; enter 1 for install or 2 for uninstall." -ForegroundColor Yellow } } } } # Find product-info.json for the selected launcher and return the IDE's # dataDirectoryName. This prevents uninstall from touching unrelated profiles. function Get-ProductDataName { param([Parameter(Mandatory)] [psobject]$Ide) if ($Ide.Type -eq 'Gateway') { return $null } $probe = $Ide.Launcher # Toolbox .cmd shims normally contain the real launcher path. if ($Ide.Type -eq 'WinCmd' -and (Test-Path -LiteralPath $probe)) { try { $cmdText = Get-Content -LiteralPath $probe -Raw -ErrorAction Stop $match = [regex]::Match($cmdText, '"([^"\r\n]+\.exe)"', [System.Text.RegularExpressions.RegexOptions]::IgnoreCase) if ($match.Success) { $expanded = [Environment]::ExpandEnvironmentVariables($match.Groups[1].Value) if (Test-Path -LiteralPath $expanded) { $probe = $expanded } } } catch { Write-Verbose ("Could not resolve Toolbox shim {0}: {1}" -f $probe, $_.Exception.Message) } } try { $item = Get-Item -LiteralPath $probe -ErrorAction Stop $dir = if ($item.PSIsContainer) { $item.FullName } else { $item.Directory.FullName } } catch { return $null } while ($dir) { foreach ($relative in @('product-info.json', 'Resources\product-info.json')) { $infoPath = Join-Path $dir $relative if (-not (Test-Path -LiteralPath $infoPath)) { continue } try { $info = Get-Content -LiteralPath $infoPath -Raw -ErrorAction Stop | ConvertFrom-Json if ($info.dataDirectoryName) { return [string]$info.dataDirectoryName } } catch { Write-Verbose ("Could not read {0}: {1}" -f $infoPath, $_.Exception.Message) } } $parent = [System.IO.Directory]::GetParent($dir) if (-not $parent) { break } $dir = $parent.FullName } return $null } function Get-PluginRoot { param([Parameter(Mandatory)] [psobject]$Ide) if ($Ide.Type -eq 'Gateway') { return (Join-Path $Ide.Client 'plugins') } $dataName = Get-ProductDataName -Ide $Ide if (-not $dataName) { return $null } return (Join-Path (Join-Path $env:APPDATA 'JetBrains') (Join-Path $dataName 'plugins')) } function ConvertFrom-PluginXml { param([Parameter(Mandatory)] [string]$Text) try { $settings = New-Object System.Xml.XmlReaderSettings $settings.DtdProcessing = [System.Xml.DtdProcessing]::Prohibit $stringReader = New-Object System.IO.StringReader($Text) $reader = [System.Xml.XmlReader]::Create($stringReader, $settings) $doc = New-Object System.Xml.XmlDocument $doc.XmlResolver = $null $doc.Load($reader) $reader.Dispose() $stringReader.Dispose() $idNode = $doc.SelectSingleNode('/idea-plugin/id') $nameNode = $doc.SelectSingleNode('/idea-plugin/name') $id = if ($idNode) { $idNode.InnerText.Trim() } elseif ($nameNode) { $nameNode.InnerText.Trim() } else { $null } $name = if ($nameNode) { $nameNode.InnerText.Trim() } else { $id } if ($id) { return [pscustomobject]@{ Id = $id; Label = $name } } } catch { Write-Verbose ("Could not parse plugin.xml: {0}" -f $_.Exception.Message) } return $null } function Get-ArchivePluginDescriptor { param([Parameter(Mandatory)] [string]$Path) $zip = $null try { $zip = [System.IO.Compression.ZipFile]::OpenRead($Path) $entry = $zip.Entries | Where-Object { $_.FullName -eq 'META-INF/plugin.xml' } | Select-Object -First 1 if (-not $entry) { return $null } $stream = $entry.Open() $reader = New-Object System.IO.StreamReader($stream) $text = $reader.ReadToEnd() $reader.Dispose() $stream.Dispose() return (ConvertFrom-PluginXml -Text $text) } catch { Write-Verbose ("Could not inspect plugin archive {0}: {1}" -f $Path, $_.Exception.Message) return $null } finally { if ($zip) { $zip.Dispose() } } } function Get-PluginDescriptor { param([Parameter(Mandatory)] [System.IO.FileSystemInfo]$Item) if (-not $Item.PSIsContainer) { return (Get-ArchivePluginDescriptor -Path $Item.FullName) } $looseXml = Join-Path $Item.FullName 'META-INF\plugin.xml' if (Test-Path -LiteralPath $looseXml) { try { return (ConvertFrom-PluginXml -Text (Get-Content -LiteralPath $looseXml -Raw -ErrorAction Stop)) } catch { Write-Verbose ("Could not inspect {0}: {1}" -f $looseXml, $_.Exception.Message) } } $archives = Get-ChildItem -LiteralPath $Item.FullName -Recurse -File -ErrorAction SilentlyContinue | Where-Object { $_.Extension -in @('.jar', '.zip') } foreach ($archive in $archives) { $descriptor = Get-ArchivePluginDescriptor -Path $archive.FullName if ($descriptor) { return $descriptor } } return $null } function Get-InstalledPlugins { param([Parameter(Mandatory)] [psobject]$Ide) $root = Get-PluginRoot -Ide $Ide if (-not $root) { Write-Host ("Could not resolve the plugin directory for: {0}" -f $Ide.Label) -ForegroundColor Yellow return } if (-not (Test-Path -LiteralPath $root)) { return } Get-ChildItem -LiteralPath $root -Force -ErrorAction SilentlyContinue | ForEach-Object { $descriptor = Get-PluginDescriptor -Item $_ if ($descriptor) { [pscustomobject]@{ Id = $descriptor.Id Label = $descriptor.Label Path = $_.FullName PluginRoot = $root TargetLabel = $Ide.Label } } } } 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 } $action = Select-Action $installedPluginInstances = @() if ($action -eq 'Install') { $pluginChoices = $PluginCatalog } else { $installedPluginInstances = @($selectedIdes | ForEach-Object { Get-InstalledPlugins -Ide $_ } | Group-Object Path | ForEach-Object { $_.Group[0] }) $pluginChoices = @($installedPluginInstances | Group-Object Id | ForEach-Object { [pscustomobject]@{ Id = $_.Name; Label = $_.Group[0].Label } } | Sort-Object Label) if ($pluginChoices.Count -eq 0) { Write-Host "No removable user-installed plugins were found for the selected IDE(s)." -ForegroundColor Yellow Write-Host "Bundled plugins cannot be uninstalled; disable them in the IDE instead." -ForegroundColor Yellow exit 0 } } $selectedPlugins = Select-Multi -Title ("Pick plugin(s) to {0}" -f $action.ToLower()) -Items $pluginChoices -Property 'Label' if ($selectedPlugins.Count -eq 0) { Write-Host "No plugins selected; exiting." -ForegroundColor Red exit 1 } # ------------------------------------------------------------------ # Running-IDE preflight # Installing or deleting plugin files requires the selected IDE to be closed. # 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') { if ($action -eq 'Install') { return $false } foreach ($name in @('jetbrains_client64', 'jetbrains_client', 'JetBrainsClient')) { if (Get-Process -Name $name -ErrorAction SilentlyContinue) { return $true } } 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 — plugin changes need 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 } # ------------------------------------------------------------------ # Uninstall or install # ------------------------------------------------------------------ if ($action -eq 'Uninstall') { $selectedIds = @($selectedPlugins | ForEach-Object { $_.Id }) $toRemove = @($installedPluginInstances | Where-Object { $_.Id -in $selectedIds } | Where-Object { $parent = [System.IO.Directory]::GetParent($_.Path) $parent -and ($parent.FullName.TrimEnd('\') -eq $_.PluginRoot.TrimEnd('\')) }) if ($toRemove.Count -eq 0) { Write-Host "None of the selected plugins are installed in the selected IDE(s)." -ForegroundColor Yellow exit 0 } Write-Host "" Write-Host "The following plugin installations will be removed:" -ForegroundColor Yellow foreach ($plugin in $toRemove) { Write-Host (" - {0} ({1})" -f $plugin.Label, $plugin.Id) Write-Host (" IDE: {0}" -f $plugin.TargetLabel) Write-Host (" Path: {0}" -f $plugin.Path) } $confirm = Read-Host "Continue? [y/N]" if ($confirm -notmatch '^[Yy]$') { Write-Host "Uninstall cancelled." exit 0 } $removed = 0 $failed = 0 $failedList = @() foreach ($plugin in $toRemove) { Write-Host -NoNewline ("Removing {0} from {1}... " -f $plugin.Label, $plugin.TargetLabel) try { Remove-Item -LiteralPath $plugin.Path -Recurse -Force -ErrorAction Stop Write-Host "ok" -ForegroundColor Green $removed++ } catch { Write-Host "FAILED" -ForegroundColor Red Write-Host (" {0}" -f $_.Exception.Message) -ForegroundColor DarkRed $failed++ $failedList += ("{0} :: {1}" -f $plugin.TargetLabel, $plugin.Id) } } Write-Host ("Done. Removed: {0}, Failed: {1}. Restart the IDE(s) to finish." -f $removed, $failed) if ($failed -gt 0) { foreach ($entry in $failedList) { Write-Host (" - {0}" -f $entry) -ForegroundColor Red } exit 1 } exit 0 } $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 }