@fredlackey/devutils 0.0.1 → 0.0.3

package/src/installs/vscode.md

@@ -0,0 +1,1002 @@
+# Installing Visual Studio Code
+
+## Overview
+
+Visual Studio Code (VS Code) is a free, open-source code editor developed by Microsoft. It provides a lightweight yet powerful development environment with built-in support for JavaScript, TypeScript, and Node.js, along with a rich ecosystem of extensions for other languages and tools. VS Code features intelligent code completion (IntelliSense), integrated debugging, Git integration, and a highly customizable interface that adapts to your workflow.
+
+VS Code is available for Windows, macOS, and Linux, making it a popular choice for cross-platform development teams. This guide documents the installation process for all platforms supported by DevUtils CLI.
+
+## Prerequisites
+
+Before installing Visual Studio Code on any platform, ensure:
+
+1. **Internet connectivity** - Required to download VS Code packages
+2. **Administrative privileges** - Required for system-wide installation (most platforms)
+3. **Sufficient disk space** - Approximately 500 MB for installation
+4. **64-bit operating system** - Required for all platforms (32-bit is deprecated)
+
+## Dependencies
+
+### macOS (Homebrew)
+- **Required:**
+  - Homebrew package manager - Install via `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"` or run `dev install homebrew`
+- **Optional:** None
+- **Auto-installed:** None (Homebrew handles all cask dependencies internally)
+
+### Ubuntu (APT/Snap)
+- **Required:**
+  - `wget` - Install via `sudo apt-get install -y wget`
+  - `gpg` - Install via `sudo apt-get install -y gpg`
+  - `apt-transport-https` - Install via `sudo apt-get install -y apt-transport-https`
+- **Optional:** None
+- **Auto-installed:** All VS Code package dependencies are automatically installed by APT (including required libraries for GUI rendering, fonts, etc.)
+
+### Raspberry Pi OS (APT/Snap)
+- **Required:**
+  - When using default Raspberry Pi OS repository: None
+  - When using Microsoft repository: `wget`, `gpg`, `apt-transport-https` - Install via `sudo apt-get install -y wget gpg apt-transport-https`
+- **Optional:** None
+- **Auto-installed:** All VS Code package dependencies are automatically installed by APT
+
+### Amazon Linux (DNF/YUM)
+- **Required:**
+  - `rpm` - Pre-installed on Amazon Linux, RHEL, and CentOS
+  - `dnf` (Amazon Linux 2023, RHEL 8+) or `yum` (Amazon Linux 2) - Pre-installed on respective platforms
+- **Optional:** None
+- **Auto-installed:**
+  - `libX11`, `libxcb`, `libXcomposite`, `libXcursor`, `libXdamage`, `libXext`, `libXfixes`, `libXi`, `libXrender`, `libXtst` - X11 GUI libraries
+  - `alsa-lib` - Audio library
+  - Note: These may need manual installation on minimal/headless systems via `sudo dnf install -y libX11 libxcb libXcomposite libXcursor libXdamage libXext libXfixes libXi libXrender libXtst alsa-lib`
+
+### Windows (Chocolatey/winget)
+- **Required:**
+  - Chocolatey package manager - Install via PowerShell: `Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))`
+  - OR winget (Windows Package Manager) - Pre-installed on Windows 11 and recent Windows 10 versions
+- **Optional:** None
+- **Auto-installed:**
+  - .NET Framework (if required by Chocolatey and not already present)
+  - Visual C++ Redistributables (if required by VS Code and not already present)
+
+### Git Bash (Manual/Portable)
+- **Required:**
+  - Visual Studio Code installed on Windows host (see Windows installation above)
+  - Chocolatey package manager (for automated installation via PowerShell interop)
+- **Optional:**
+  - `winpty` - Enables TTY compatibility for interactive VS Code features in Git Bash - Pre-installed with Git for Windows
+- **Auto-installed:** None (Git Bash inherits the Windows PATH and accesses the Windows VS Code installation directly)
+
+## Platform-Specific Installation
+
+### macOS (Homebrew)
+
+#### Prerequisites
+
+- macOS 10.15 (Catalina) or later
+- Homebrew package manager installed
+- Apple Silicon (M1/M2/M3/M4) or Intel processor
+
+If Homebrew is not installed, install it first:
+
+```bash
+/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+```
+
+#### Installation Steps
+
+Run the following command to install Visual Studio Code:
+
+```bash
+brew install --quiet --cask visual-studio-code
+```
+
+The `--quiet` flag suppresses non-essential output for cleaner installation logs. The `--cask` option specifies the graphical application version.
+
+After installation, add the `code` command to your PATH for terminal access. This step is normally automatic on modern versions, but if needed, add manually:
+
+**For Zsh (default on macOS):**
+
+```bash
+cat << 'EOF' >> ~/.zprofile
+# Add Visual Studio Code (code)
+export PATH="$PATH:/Applications/Visual Studio Code.app/Contents/Resources/app/bin"
+EOF
+source ~/.zprofile
+```
+
+**For Bash:**
+
+```bash
+cat << 'EOF' >> ~/.bash_profile
+# Add Visual Studio Code (code)
+export PATH="$PATH:/Applications/Visual Studio Code.app/Contents/Resources/app/bin"
+EOF
+source ~/.bash_profile
+```
+
+#### Verification
+
+Confirm the installation succeeded:
+
+```bash
+code --version
+```
+
+Expected output (version numbers may vary):
+
+```
+1.107.1
+e54c774e0add60467559eb0d1e229c6452cf8447
+x64
+```
+
+Test that VS Code launches correctly:
+
+```bash
+code --help
+```
+
+#### Troubleshooting
+
+**Problem**: `code: command not found` after installation
+
+**Solution**: The `code` command may not be in your PATH. Either add it manually (see Installation Steps above) or launch VS Code, open the Command Palette (Cmd+Shift+P), and run "Shell Command: Install 'code' command in PATH".
+
+**Problem**: "Visual Studio Code.app" is damaged and can't be opened
+
+**Solution**: Clear the quarantine attribute:
+
+```bash
+xattr -cr "/Applications/Visual Studio Code.app"
+```
+
+**Problem**: Homebrew reports the cask is already installed
+
+**Solution**: Reinstall to update:
+
+```bash
+brew reinstall --cask visual-studio-code
+```
+
+---
+
+### Ubuntu/Debian (APT)
+
+#### Prerequisites
+
+- Ubuntu 20.04 (Focal) or later, or Debian 10 (Buster) or later (64-bit)
+- sudo privileges
+- wget and gpg utilities
+
+**Important**: Do not use `apt install code` without first adding Microsoft's repository. The package may not exist or may be outdated.
+
+#### Installation Steps
+
+**Step 1: Install prerequisites and import Microsoft's GPG key**
+
+```bash
+sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
+sudo DEBIAN_FRONTEND=noninteractive apt-get install -y wget gpg apt-transport-https
+wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > /tmp/microsoft.gpg
+sudo install -D -o root -g root -m 644 /tmp/microsoft.gpg /usr/share/keyrings/microsoft.gpg
+rm -f /tmp/microsoft.gpg
+```
+
+**Step 2: Add Microsoft's APT repository**
+
+```bash
+echo "Types: deb
+URIs: https://packages.microsoft.com/repos/code
+Suites: stable
+Components: main
+Architectures: amd64,arm64,armhf
+Signed-By: /usr/share/keyrings/microsoft.gpg" | sudo tee /etc/apt/sources.list.d/vscode.sources > /dev/null
+```
+
+**Step 3: Install Visual Studio Code**
+
+```bash
+sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
+sudo DEBIAN_FRONTEND=noninteractive apt-get install -y code
+```
+
+The `DEBIAN_FRONTEND=noninteractive` environment variable and `-y` flag ensure fully automated installation with no prompts.
+
+#### Verification
+
+Confirm the installation succeeded:
+
+```bash
+code --version
+```
+
+Expected output (version numbers may vary):
+
+```
+1.107.1
+e54c774e0add60467559eb0d1e229c6452cf8447
+x64
+```
+
+Verify the package is from Microsoft's repository:
+
+```bash
+apt-cache policy code
+```
+
+The output should show `https://packages.microsoft.com/repos/code` as the source.
+
+#### Troubleshooting
+
+**Problem**: `E: Unable to locate package code`
+
+**Solution**: The repository was not added correctly. Verify the sources file exists and has correct content:
+
+```bash
+cat /etc/apt/sources.list.d/vscode.sources
+```
+
+If missing or malformed, repeat Steps 1 and 2.
+
+**Problem**: GPG key import fails with permission errors
+
+**Solution**: Ensure wget and gpg are installed, and use a temporary file with proper permissions:
+
+```bash
+sudo DEBIAN_FRONTEND=noninteractive apt-get install -y wget gpg
+wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor | sudo tee /usr/share/keyrings/microsoft.gpg > /dev/null
+```
+
+**Problem**: VS Code does not launch on headless server
+
+**Solution**: VS Code requires a graphical display. For remote development, use the Remote-SSH extension from a desktop VS Code instance, or install on a desktop system.
+
+**Problem**: Pop!_OS or other distributions install wrong package
+
+**Solution**: Create a preferences file to prioritize Microsoft's repository:
+
+```bash
+echo 'Package: code
+Pin: origin "packages.microsoft.com"
+Pin-Priority: 9999' | sudo tee /etc/apt/preferences.d/code
+```
+
+---
+
+### Raspberry Pi OS (APT)
+
+#### Prerequisites
+
+- Raspberry Pi OS (64-bit recommended) - Bookworm or Bullseye
+- Raspberry Pi 3B+ or later (64-bit capable hardware recommended)
+- At least 1 GB RAM (2 GB or more recommended for comfortable usage)
+- sudo privileges
+
+Verify your architecture:
+
+```bash
+uname -m
+```
+
+- `aarch64` = 64-bit (recommended)
+- `armv7l` = 32-bit (limited performance)
+
+#### Installation Steps
+
+VS Code is available in the official Raspberry Pi OS APT repository. Run these commands:
+
+```bash
+sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
+sudo DEBIAN_FRONTEND=noninteractive apt-get install -y code
+```
+
+The Raspberry Pi OS repository includes ARM-compatible builds of VS Code, eliminating the need to manually add Microsoft's repository.
+
+**Alternative for latest version (if Raspberry Pi OS repo is outdated):**
+
+If you need the latest VS Code version, add Microsoft's repository instead:
+
+```bash
+# Install prerequisites
+sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
+sudo DEBIAN_FRONTEND=noninteractive apt-get install -y wget gpg apt-transport-https
+
+# Import GPG key
+wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > /tmp/microsoft.gpg
+sudo install -D -o root -g root -m 644 /tmp/microsoft.gpg /usr/share/keyrings/microsoft.gpg
+rm -f /tmp/microsoft.gpg
+
+# Add repository
+echo "Types: deb
+URIs: https://packages.microsoft.com/repos/code
+Suites: stable
+Components: main
+Architectures: arm64,armhf
+Signed-By: /usr/share/keyrings/microsoft.gpg" | sudo tee /etc/apt/sources.list.d/vscode.sources > /dev/null
+
+# Install
+sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
+sudo DEBIAN_FRONTEND=noninteractive apt-get install -y code
+```
+
+#### Verification
+
+Confirm the installation succeeded:
+
+```bash
+code --version
+```
+
+Expected output (version numbers may vary):
+
+```
+1.107.1
+e54c774e0add60467559eb0d1e229c6452cf8447
+arm64
+```
+
+Launch VS Code:
+
+```bash
+code
+```
+
+#### Troubleshooting
+
+**Problem**: VS Code is very slow or unresponsive
+
+**Solution**: Disable hardware acceleration. Open VS Code, press Ctrl+Shift+P, type "Preferences: Configure Runtime Arguments", and add:
+
+```json
+{
+  "disable-hardware-acceleration": true
+}
+```
+
+Alternatively, launch with the flag:
+
+```bash
+code --disable-gpu
+```
+
+**Problem**: Out of memory errors
+
+**Solution**: Close other applications and consider adding swap space:
+
+```bash
+sudo fallocate -l 2G /swapfile
+sudo chmod 600 /swapfile
+sudo mkswap /swapfile
+sudo swapon /swapfile
+echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
+```
+
+**Problem**: VS Code not found in Programming menu
+
+**Solution**: Refresh the desktop environment:
+
+```bash
+lxpanelctl restart
+```
+
+**Problem**: Display issues on older Raspberry Pi models
+
+**Solution**: Use the 32-bit version of Raspberry Pi OS for Raspberry Pi 3B or earlier, and ensure GPU memory is set appropriately in `raspi-config`.
+
+---
+
+### Amazon Linux/RHEL (DNF/YUM)
+
+#### Prerequisites
+
+- Amazon Linux 2023 (AL2023), Amazon Linux 2 (AL2), RHEL 8+, or CentOS 8+
+- sudo privileges
+- 64-bit system
+
+**Note**: Amazon Linux 2023 uses DNF as the package manager. Amazon Linux 2 uses YUM. This guide uses DNF commands; replace `dnf` with `yum` for AL2.
+
+#### Installation Steps
+
+**Step 1: Import Microsoft's GPG key and add the repository**
+
+```bash
+sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
+echo -e "[code]\nname=Visual Studio Code\nbaseurl=https://packages.microsoft.com/yumrepos/vscode\nenabled=1\nautorefresh=1\ntype=rpm-md\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" | sudo tee /etc/yum.repos.d/vscode.repo > /dev/null
+```
+
+**Step 2: Install Visual Studio Code**
+
+For Amazon Linux 2023 and RHEL 8+ (DNF):
+
+```bash
+sudo dnf check-update || true
+sudo dnf install -y code
+```
+
+For Amazon Linux 2 (YUM):
+
+```bash
+sudo yum check-update || true
+sudo yum install -y code
+```
+
+The `|| true` ensures the command does not fail if there are no updates (check-update returns exit code 100 when updates are available).
+
+#### Verification
+
+Confirm the installation succeeded:
+
+```bash
+code --version
+```
+
+Expected output (version numbers may vary):
+
+```
+1.107.1
+e54c774e0add60467559eb0d1e229c6452cf8447
+x64
+```
+
+Verify the repository is configured:
+
+```bash
+dnf repolist | grep code
+```
+
+#### Troubleshooting
+
+**Problem**: `No package code available`
+
+**Solution**: The repository was not added correctly. Verify the repo file:
+
+```bash
+cat /etc/yum.repos.d/vscode.repo
+```
+
+Ensure it contains the `[code]` section with the correct baseurl.
+
+**Problem**: GPG key import fails
+
+**Solution**: Import the key manually with curl:
+
+```bash
+curl -sSL https://packages.microsoft.com/keys/microsoft.asc | sudo rpm --import -
+```
+
+**Problem**: VS Code fails to launch with display errors
+
+**Solution**: Ensure X11 forwarding is enabled if connecting remotely, or use the Remote-SSH extension from a desktop installation.
+
+**Problem**: Dependency conflicts on older systems
+
+**Solution**: Install required libraries:
+
+```bash
+sudo dnf install -y libX11 libxcb libXcomposite libXcursor libXdamage libXext libXfixes libXi libXrender libXtst alsa-lib
+```
+
+---
+
+### Windows (Chocolatey)
+
+#### Prerequisites
+
+- Windows 10 version 1709 or later (64-bit), or Windows 11
+- Administrator PowerShell or Command Prompt
+- Chocolatey package manager installed
+
+If Chocolatey is not installed, install it first by running this command in an Administrator PowerShell:
+
+```powershell
+Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
+```
+
+#### Installation Steps
+
+Run the following command in an Administrator PowerShell or Command Prompt:
+
+```powershell
+choco install vscode -y
+```
+
+The `-y` flag automatically confirms all prompts, enabling fully non-interactive installation.
+
+The Chocolatey package automatically:
+- Adds VS Code to the system PATH
+- Creates "Open with Code" context menu entries for files and folders
+- Does NOT start VS Code after installation
+- Does NOT create a desktop icon (by default)
+
+**To customize the installation:**
+
+```powershell
+choco install vscode -y --params "/NoContextMenuFiles /NoContextMenuFolders"
+```
+
+Available parameters:
+- `/NoDesktopIcon` - Skip creating a desktop shortcut
+- `/NoQuicklaunchIcon` - Skip Quick Launch icon
+- `/NoContextMenuFiles` - Remove "Open with Code" from file context menu
+- `/NoContextMenuFolders` - Remove "Open with Code" from folder context menu
+- `/DontAddToPath` - Do not add to system PATH
+
+#### Verification
+
+Open a **new** Command Prompt or PowerShell window (to pick up PATH changes), then run:
+
+```powershell
+code --version
+```
+
+Expected output (version numbers may vary):
+
+```
+1.107.1
+e54c774e0add60467559eb0d1e229c6452cf8447
+x64
+```
+
+#### Troubleshooting
+
+**Problem**: `code: The term 'code' is not recognized`
+
+**Solution**: Open a new terminal window to refresh the PATH. If the problem persists, add VS Code to PATH manually:
+
+```powershell
+$vscodePath = "$env:LOCALAPPDATA\Programs\Microsoft VS Code\bin"
+[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$vscodePath", "User")
+```
+
+**Problem**: Installation requires restart
+
+**Solution**: Some Windows updates may require a restart. Chocolatey will notify you if this is needed:
+
+```powershell
+choco install vscode -y
+shutdown /r /t 60 /c "Restarting to complete VS Code installation"
+```
+
+**Problem**: Chocolatey installation blocked by antivirus
+
+**Solution**: Temporarily disable real-time scanning or add an exception for the Chocolatey directory (`C:\ProgramData\chocolatey`).
+
+---
+
+### Windows (winget)
+
+#### Prerequisites
+
+- Windows 10 version 1809 or later (64-bit), or Windows 11
+- Windows Package Manager (winget) - Pre-installed on Windows 11 and Windows 10 (recent versions)
+
+Verify winget is available:
+
+```powershell
+winget --version
+```
+
+#### Installation Steps
+
+Run the following command in PowerShell or Command Prompt:
+
+```powershell
+winget install --id Microsoft.VisualStudioCode --silent --accept-package-agreements --accept-source-agreements
+```
+
+The flags ensure fully non-interactive installation:
+- `--id Microsoft.VisualStudioCode` - Exact package identifier
+- `--silent` - No installation UI
+- `--accept-package-agreements` - Automatically accept license agreements
+- `--accept-source-agreements` - Automatically accept source repository agreements
+
+**For custom installation options:**
+
+```powershell
+winget install --id Microsoft.VisualStudioCode --silent --accept-package-agreements --accept-source-agreements --override "/VERYSILENT /SP- /MERGETASKS=!runcode,addcontextmenufiles,addcontextmenufolders,associatewithfiles,addtopath"
+```
+
+The `/MERGETASKS` parameter controls which installation tasks are performed. Note the exact spelling - a common typo is "MERGETAKS" which is silently ignored.
+
+#### Verification
+
+Open a **new** terminal window, then run:
+
+```powershell
+code --version
+```
+
+Expected output (version numbers may vary):
+
+```
+1.107.1
+e54c774e0add60467559eb0d1e229c6452cf8447
+x64
+```
+
+#### Troubleshooting
+
+**Problem**: `No package found matching input criteria`
+
+**Solution**: Update the winget source:
+
+```powershell
+winget source update
+winget install --id Microsoft.VisualStudioCode --silent --accept-package-agreements --accept-source-agreements
+```
+
+**Problem**: Installation hangs or times out
+
+**Solution**: Try the User scope installation:
+
+```powershell
+winget install --id Microsoft.VisualStudioCode --scope user --silent --accept-package-agreements --accept-source-agreements
+```
+
+---
+
+### WSL (Ubuntu)
+
+#### Prerequisites
+
+- Windows 10 version 2004 or later, or Windows 11
+- WSL 2 enabled with Ubuntu distribution installed
+- sudo privileges within WSL
+
+**Recommended Approach**: Install VS Code on Windows and use the Remote-WSL extension. This is Microsoft's recommended workflow and provides the best performance.
+
+#### Installation Steps
+
+**Recommended: VS Code on Windows with Remote-WSL**
+
+1. Install VS Code on Windows using Chocolatey or winget (see Windows sections above)
+
+2. Launch VS Code from within WSL:
+
+```bash
+code .
+```
+
+On first run, VS Code automatically downloads and installs the VS Code Server in WSL, enabling seamless development.
+
+**Alternative: Native VS Code in WSL (for GUI-enabled WSL)**
+
+If you have WSLg (Windows 11) or an X server configured, you can install VS Code natively in WSL:
+
+```bash
+# Install prerequisites
+sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
+sudo DEBIAN_FRONTEND=noninteractive apt-get install -y wget gpg apt-transport-https
+
+# Import GPG key
+wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > /tmp/microsoft.gpg
+sudo install -D -o root -g root -m 644 /tmp/microsoft.gpg /usr/share/keyrings/microsoft.gpg
+rm -f /tmp/microsoft.gpg
+
+# Add repository
+echo "Types: deb
+URIs: https://packages.microsoft.com/repos/code
+Suites: stable
+Components: main
+Architectures: amd64,arm64,armhf
+Signed-By: /usr/share/keyrings/microsoft.gpg" | sudo tee /etc/apt/sources.list.d/vscode.sources > /dev/null
+
+# Install
+sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
+sudo DEBIAN_FRONTEND=noninteractive apt-get install -y code
+```
+
+#### Verification
+
+For the recommended approach (VS Code on Windows):
+
+```bash
+code --version
+```
+
+This should launch the Windows VS Code and display version information.
+
+For native WSL installation:
+
+```bash
+code --version
+```
+
+Expected output (version numbers may vary):
+
+```
+1.107.1
+e54c774e0add60467559eb0d1e229c6452cf8447
+x64
+```
+
+#### Troubleshooting
+
+**Problem**: `code` command not found in WSL
+
+**Solution**: For the Windows approach, ensure VS Code is installed on Windows and the WSL integration is enabled. Open VS Code on Windows, install the "Remote - WSL" extension, and restart your WSL terminal.
+
+**Problem**: VS Code opens but cannot access WSL files
+
+**Solution**: Launch VS Code from within the WSL terminal:
+
+```bash
+cd /home/user/project
+code .
+```
+
+**Problem**: GUI does not display for native WSL installation
+
+**Solution**: Ensure WSLg is enabled (Windows 11) or configure an X server (Windows 10). For Windows 11:
+
+```powershell
+wsl --update
+```
+
+**Problem**: Extensions do not work in WSL
+
+**Solution**: Extensions must be installed separately in the WSL context. Open VS Code in WSL, go to Extensions, and click "Install in WSL: Ubuntu" for each extension.
+
+---
+
+### Git Bash (Windows Installation)
+
+#### Prerequisites
+
+- Windows 10 or Windows 11 (64-bit)
+- Git Bash installed (comes with Git for Windows)
+- VS Code installed on Windows (see Windows sections above)
+
+**Note**: Git Bash on Windows does not require a separate VS Code installation. Git Bash inherits the Windows PATH, so once VS Code is installed on Windows, the `code` command is automatically available in Git Bash.
+
+#### Installation Steps
+
+1. Install VS Code on Windows using Chocolatey (recommended):
+
+```powershell
+# Run from Administrator PowerShell or Command Prompt
+choco install vscode -y
+```
+
+2. Open Git Bash - the `code` command will be available
+
+No additional configuration is typically required as Git Bash inherits the Windows PATH.
+
+#### Verification
+
+In Git Bash, confirm VS Code is accessible:
+
+```bash
+code --version
+```
+
+Expected output (version numbers may vary):
+
+```
+1.107.1
+e54c774e0add60467559eb0d1e229c6452cf8447
+x64
+```
+
+Open a project:
+
+```bash
+code .
+```
+
+#### Troubleshooting
+
+**Problem**: `code: command not found` in Git Bash
+
+**Solution**: VS Code may not be in PATH. Add it manually to your `~/.bashrc`:
+
+```bash
+echo 'export PATH="$PATH:/c/Users/$USER/AppData/Local/Programs/Microsoft VS Code/bin"' >> ~/.bashrc
+source ~/.bashrc
+```
+
+If VS Code is installed system-wide:
+
+```bash
+echo 'export PATH="$PATH:/c/Program Files/Microsoft VS Code/bin"' >> ~/.bashrc
+source ~/.bashrc
+```
+
+**Problem**: `the input device is not a TTY` when using integrated terminal features
+
+**Solution**: Git Bash's mintty terminal has TTY compatibility issues. Use `winpty` prefix for interactive commands:
+
+```bash
+winpty code --wait
+```
+
+Or add an alias to your `~/.bashrc`:
+
+```bash
+echo 'alias code="winpty code"' >> ~/.bashrc
+source ~/.bashrc
+```
+
+**Problem**: File paths not recognized correctly
+
+**Solution**: Git Bash may convert Unix-style paths. Use Windows-style paths or escape forward slashes:
+
+```bash
+# Use Windows path
+code "C:\Users\username\project"
+
+# Or escape the path
+code //c/Users/username/project
+```
+
+---
+
+## Post-Installation Configuration
+
+After installing VS Code on any platform, consider these recommended configurations.
+
+### Installing Essential Extensions
+
+Install commonly used extensions from the command line:
+
+```bash
+# Install essential extensions non-interactively
+code --install-extension ms-vscode.vscode-typescript-next
+code --install-extension esbenp.prettier-vscode
+code --install-extension dbaeumer.vscode-eslint
+code --install-extension eamodio.gitlens
+```
+
+### Configuring Settings Sync
+
+VS Code can synchronize settings across devices using your Microsoft or GitHub account. Enable in VS Code:
+
+1. Click the gear icon (Settings) in the bottom-left
+2. Select "Turn on Settings Sync..."
+3. Sign in with Microsoft or GitHub
+
+### Setting Default Editor for Git
+
+Configure VS Code as Git's default editor:
+
+```bash
+git config --global core.editor "code --wait"
+```
+
+Configure VS Code as the default diff and merge tool:
+
+```bash
+git config --global diff.tool vscode
+git config --global difftool.vscode.cmd 'code --wait --diff $LOCAL $REMOTE'
+git config --global merge.tool vscode
+git config --global mergetool.vscode.cmd 'code --wait $MERGED'
+```
+
+### Enabling Auto-Update (Linux)
+
+On Linux systems using APT or DNF, VS Code updates automatically through the system package manager. To update manually:
+
+**APT (Ubuntu/Debian/Raspberry Pi):**
+
+```bash
+sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
+sudo DEBIAN_FRONTEND=noninteractive apt-get upgrade -y code
+```
+
+**DNF (Amazon Linux/RHEL):**
+
+```bash
+sudo dnf upgrade -y code
+```
+
+---
+
+## Common Issues
+
+### Issue: VS Code Opens Blank or White Screen
+
+**Symptoms**: VS Code window opens but shows blank content
+
+**Solutions**:
+
+Disable GPU acceleration:
+
+```bash
+code --disable-gpu
+```
+
+To make permanent, add to VS Code settings:
+
+1. Open Command Palette (Ctrl+Shift+P or Cmd+Shift+P)
+2. Search "Preferences: Configure Runtime Arguments"
+3. Add: `"disable-hardware-acceleration": true`
+
+### Issue: High CPU Usage
+
+**Symptoms**: VS Code consumes excessive CPU, especially with TypeScript projects
+
+**Solutions**:
+
+Exclude large folders from file watching in settings.json:
+
+```json
+{
+  "files.watcherExclude": {
+    "**/node_modules/**": true,
+    "**/.git/**": true
+  }
+}
+```
+
+### Issue: Extensions Not Loading
+
+**Symptoms**: Extensions fail to activate or load
+
+**Solutions**:
+
+Clear the extension cache:
+
+```bash
+# Linux/macOS
+rm -rf ~/.vscode/extensions
+
+# Windows (PowerShell)
+Remove-Item -Recurse -Force "$env:USERPROFILE\.vscode\extensions"
+```
+
+Reinstall extensions after clearing.
+
+### Issue: Cannot Save Files (Permission Denied)
+
+**Symptoms**: Error saving files in certain directories
+
+**Solutions**:
+
+Check file ownership and permissions:
+
+```bash
+ls -la filename
+```
+
+For system directories, consider using the "Save as Root" extension or fixing permissions:
+
+```bash
+sudo chown -R $USER:$USER /path/to/directory
+```
+
+### Issue: Integrated Terminal Not Working
+
+**Symptoms**: Terminal fails to open or shows errors
+
+**Solutions**:
+
+Reset terminal settings:
+
+1. Open settings.json
+2. Remove any terminal-related customizations
+3. Restart VS Code
+
+Set default shell explicitly:
+
+```json
+{
+  "terminal.integrated.defaultProfile.linux": "bash",
+  "terminal.integrated.defaultProfile.osx": "zsh",
+  "terminal.integrated.defaultProfile.windows": "PowerShell"
+}
+```
+
+---
+
+## References
+
+- [Visual Studio Code Official Website](https://code.visualstudio.com/)
+- [VS Code Documentation](https://code.visualstudio.com/docs)
+- [VS Code on macOS](https://code.visualstudio.com/docs/setup/mac)
+- [VS Code on Linux](https://code.visualstudio.com/docs/setup/linux)
+- [VS Code on Windows](https://code.visualstudio.com/docs/setup/windows)
+- [VS Code on Raspberry Pi](https://code.visualstudio.com/docs/setup/raspberry-pi)
+- [Homebrew Cask: visual-studio-code](https://formulae.brew.sh/cask/visual-studio-code)
+- [Chocolatey Package: vscode](https://community.chocolatey.org/packages/vscode)
+- [Winget Package: Microsoft.VisualStudioCode](https://winget.run/pkg/Microsoft/VisualStudioCode)
+- [VS Code Remote Development](https://code.visualstudio.com/docs/remote/remote-overview)
+- [VS Code Release Notes](https://code.visualstudio.com/updates)