@fredlackey/devutils 0.0.1 → 0.0.3

package/src/installs/chatgpt.md

@@ -0,0 +1,814 @@
+# Installing ChatGPT Desktop Application
+
+## Overview
+
+ChatGPT is OpenAI's AI assistant available as a desktop application for macOS and Windows. The desktop app provides a native experience with features like keyboard shortcuts (Option+Space on macOS, Alt+Space on Windows) for quick access, voice conversations with Advanced Voice mode, file uploads, image generation, and seamless integration with your workflow. The app maintains conversation history and supports memory features that persist across sessions.
+
+**Important Platform Notes**:
+- OpenAI provides official desktop applications for **macOS (Apple Silicon only)** and **Windows**
+- **Linux, Raspberry Pi OS, and Amazon Linux** do not have official OpenAI desktop applications
+- For unsupported platforms, third-party desktop wrappers or the web interface (https://chat.openai.com) are available alternatives
+
+## Dependencies
+
+### macOS (Homebrew)
+- **Required:**
+  - `brew` - Install via `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"` or run `dev install homebrew`
+  - Apple Silicon (ARM64) processor - The official ChatGPT app requires M1/M2/M3 or later (Intel Macs not supported)
+- **Optional:** None
+- **Auto-installed:** None
+
+### Ubuntu (APT/Snap)
+- **Required:**
+  - `snapd` - Install via `sudo apt-get update && sudo apt-get install -y snapd` (pre-installed on Ubuntu 16.04+)
+- **Optional:** None
+- **Auto-installed:** None
+
+### Raspberry Pi OS (APT/Snap)
+- **Required:** None (Installation not supported on this platform)
+- **Optional:** None
+- **Auto-installed:** None
+- **Note:** ChatGPT desktop app is not available for Raspberry Pi OS. Third-party Snap packages do not support ARM64 architecture. Use the web interface at https://chat.openai.com instead.
+
+### Amazon Linux (DNF/YUM)
+- **Required:** None (Installation not supported on this platform)
+- **Optional:** None
+- **Auto-installed:** None
+- **Note:** ChatGPT desktop app is not available for Amazon Linux. This is typically a server OS without a desktop environment. Use the ChatGPT API via the OpenAI Python library or access the web interface.
+
+### Windows (Chocolatey/winget)
+- **Required:**
+  - `winget` - Install via Microsoft Store: `start ms-windows-store://pdp/?productid=9NBLGGH4NNS1` (pre-installed on Windows 10 1809+ and Windows 11)
+- **Optional:** None
+- **Auto-installed:** None
+
+### Git Bash (Manual/Portable)
+- **Required:**
+  - `winget.exe` - Install via Microsoft Store: `start ms-windows-store://pdp/?productid=9NBLGGH4NNS1` (pre-installed on Windows 10 1809+ and Windows 11)
+- **Optional:** None
+- **Auto-installed:** None
+- **Note:** Git Bash delegates to the Windows installation process using winget.exe
+
+### WSL (Ubuntu)
+- **Required:**
+  - `wslu` - Install via `sudo apt-get update && sudo apt-get install -y wslu` (provides wslview command for opening Windows browser)
+- **Optional:**
+  - `winget.exe` - Accessible from WSL if available on Windows host (for installing Windows ChatGPT app)
+  - `snapd` - Install via `sudo apt-get install -y snapd` (for running Linux GUI apps in WSL 2 + WSLg on Windows 11)
+- **Auto-installed:** None
+
+## Prerequisites
+
+Before installing ChatGPT desktop on any platform, ensure:
+
+1. **OpenAI account** - A free or paid OpenAI account is required to use ChatGPT
+2. **Internet connectivity** - Required for all ChatGPT functionality (the app connects to OpenAI servers)
+3. **Administrative privileges** - Required on most platforms for installation
+
+## Platform-Specific Installation
+
+### macOS (Homebrew)
+
+#### Prerequisites
+
+- macOS 14 (Sonoma) or later
+- Apple Silicon processor (M1, M2, M3, or later) - **Intel Macs are not supported**
+- Homebrew package manager installed
+- Terminal access
+
+**Note**: The official ChatGPT desktop app from OpenAI requires Apple Silicon. Intel Mac users must use the web interface at https://chat.openai.com or third-party alternatives.
+
+If Homebrew is not installed, install it first:
+
+```bash
+NONINTERACTIVE=1 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+```
+
+#### Installation Steps
+
+Run the following command to install the official OpenAI ChatGPT desktop app:
+
+```bash
+brew install --cask --quiet chatgpt
+```
+
+The `--quiet` flag suppresses non-essential output, making the command suitable for automation scripts. The `--cask` flag specifies this is a macOS application (as opposed to a command-line tool).
+
+#### Verification
+
+Confirm the installation succeeded by launching the application:
+
+```bash
+open -a ChatGPT
+```
+
+Alternatively, verify the application exists:
+
+```bash
+ls /Applications/ChatGPT.app
+```
+
+Expected output:
+
+```
+/Applications/ChatGPT.app
+```
+
+#### Troubleshooting
+
+**Problem**: Installation fails with "You need macOS 14 or later"
+
+**Solution**: The official ChatGPT app requires macOS 14 (Sonoma) or later. Upgrade your operating system or use the web interface at https://chat.openai.com.
+
+**Problem**: Installation fails with "This cask requires Apple Silicon"
+
+**Solution**: The official ChatGPT desktop app only supports Apple Silicon Macs. Intel Mac users must use the web interface or third-party alternatives. Check your processor:
+
+```bash
+uname -m
+```
+
+If the output is `x86_64`, you have an Intel Mac. If it is `arm64`, you have Apple Silicon.
+
+**Problem**: App shows "ChatGPT can't be opened because Apple cannot check it for malicious software"
+
+**Solution**: This can occur on first launch. Right-click the app in Applications and select "Open", then click "Open" in the dialog. Alternatively, clear the quarantine flag:
+
+```bash
+xattr -cr /Applications/ChatGPT.app
+```
+
+**Problem**: `brew: command not found`
+
+**Solution**: Homebrew is not installed or not in PATH. Install Homebrew or add it to your PATH:
+
+```bash
+eval "$(/opt/homebrew/bin/brew shellenv)"
+```
+
+---
+
+### Ubuntu/Debian (Snap)
+
+#### Prerequisites
+
+- Ubuntu 20.04 or later, or Debian 11 or later (64-bit x86_64)
+- snapd service installed and running (pre-installed on Ubuntu 16.04+)
+- sudo privileges
+- Active internet connection
+
+**Important**: OpenAI does not provide an official ChatGPT desktop application for Linux. The Snap package available is a third-party Electron wrapper that provides a native window for the ChatGPT web interface. This is not developed or maintained by OpenAI.
+
+#### Installation Steps
+
+Run the following command to install the ChatGPT desktop wrapper:
+
+```bash
+sudo snap install chatgpt-desktop
+```
+
+This installs a third-party Electron-based desktop wrapper that provides a native window for ChatGPT with features like persistent login and keyboard shortcuts.
+
+**Note**: After installation, you may need to log out and log back in, or restart your terminal, for the application to appear in your application menu.
+
+#### Verification
+
+Confirm the installation succeeded:
+
+```bash
+snap list chatgpt-desktop
+```
+
+Expected output (version may vary):
+
+```
+Name             Version  Rev    Tracking       Publisher         Notes
+chatgpt-desktop  1.0.7    xxx    latest/stable  joshua-redmond    -
+```
+
+Launch the application:
+
+```bash
+chatgpt-desktop &
+```
+
+Or find "ChatGPT Desktop" in your application menu.
+
+#### Troubleshooting
+
+**Problem**: `snap: command not found`
+
+**Solution**: Install snapd first:
+
+```bash
+sudo DEBIAN_FRONTEND=noninteractive apt-get update -y && sudo DEBIAN_FRONTEND=noninteractive apt-get install -y snapd
+```
+
+Then restart your terminal or log out and log back in.
+
+**Problem**: Application fails to start with graphics errors
+
+**Solution**: The Electron-based app may have issues with certain graphics drivers. Try running with software rendering:
+
+```bash
+chatgpt-desktop --disable-gpu &
+```
+
+**Problem**: Cannot log in to ChatGPT within the app
+
+**Solution**: Clear the application data and try again:
+
+```bash
+rm -rf ~/snap/chatgpt-desktop/current/.config/chatgpt-desktop
+```
+
+**Problem**: "chatgpt-desktop" not found after installation
+
+**Solution**: The snap bin directory may not be in PATH. Add it:
+
+```bash
+export PATH=$PATH:/snap/bin
+```
+
+Add this line to `~/.bashrc` for persistence.
+
+---
+
+### Raspberry Pi OS (Snap)
+
+#### Prerequisites
+
+- Raspberry Pi OS (64-bit) - ARM64/aarch64 architecture
+- Raspberry Pi 4 or later with 4GB+ RAM recommended
+- snapd service installed
+- sudo privileges
+- Display and desktop environment configured
+
+**Important**: OpenAI does not provide an official ChatGPT desktop application for Raspberry Pi or any Linux ARM platform. Third-party desktop wrappers exist but may have limited ARM64 support. The web interface at https://chat.openai.com is the recommended solution for Raspberry Pi.
+
+Verify your architecture:
+
+```bash
+uname -m
+```
+
+This must output `aarch64`. If it outputs `armv7l`, you are running 32-bit Raspberry Pi OS and need to install the 64-bit version.
+
+#### Installation Steps
+
+**Recommended Approach - Web Browser**:
+
+The most reliable way to use ChatGPT on Raspberry Pi is through the web browser. Chromium is pre-installed on Raspberry Pi OS:
+
+```bash
+chromium-browser https://chat.openai.com &
+```
+
+**Alternative Approach - Third-Party Snap (Limited Support)**:
+
+Third-party ChatGPT desktop wrappers are primarily built for x86_64 architecture. ARM64 support is limited. Check if the snap supports ARM64:
+
+```bash
+snap info chatgpt-desktop
+```
+
+If ARM64 (aarch64) is listed under supported architectures, install with:
+
+```bash
+sudo snap install chatgpt-desktop
+```
+
+**Note**: Most ChatGPT desktop Snap packages only support amd64 (x86_64) and will not install on Raspberry Pi.
+
+#### Verification
+
+For the browser approach, verify Chromium can access ChatGPT:
+
+```bash
+chromium-browser --version
+```
+
+Navigate to https://chat.openai.com and confirm the page loads.
+
+For snap installation (if supported), verify with:
+
+```bash
+snap list chatgpt-desktop
+```
+
+#### Troubleshooting
+
+**Problem**: Snap installation fails with "architecture not supported"
+
+**Solution**: The snap package does not support ARM64. Use the web browser method instead:
+
+```bash
+chromium-browser https://chat.openai.com &
+```
+
+**Problem**: Web interface is slow or unresponsive
+
+**Solution**: Raspberry Pi may have limited resources for web-based AI interfaces. Close other applications and ensure you have at least 4GB RAM. Consider using a lighter browser:
+
+```bash
+sudo DEBIAN_FRONTEND=noninteractive apt-get install -y firefox-esr
+firefox https://chat.openai.com &
+```
+
+**Problem**: Cannot install snapd
+
+**Solution**: Install snapd and reboot:
+
+```bash
+sudo DEBIAN_FRONTEND=noninteractive apt-get update -y && sudo DEBIAN_FRONTEND=noninteractive apt-get install -y snapd
+sudo reboot
+```
+
+---
+
+### Amazon Linux (DNF/YUM)
+
+#### Prerequisites
+
+- Amazon Linux 2023 (AL2023) or Amazon Linux 2 (AL2)
+- Desktop environment (if using a graphical interface)
+- sudo privileges
+
+**Important**: OpenAI does not provide an official ChatGPT desktop application for Amazon Linux or any Linux distribution. Amazon Linux is typically used as a server operating system without a desktop environment. For server environments, use the ChatGPT API via the OpenAI Python library or access the web interface.
+
+#### Installation Steps
+
+**Recommended Approach - Web Interface or API**:
+
+For server environments (most Amazon Linux use cases), access ChatGPT via the API:
+
+```bash
+sudo dnf install -y python3-pip
+pip3 install --quiet openai
+```
+
+Then use the OpenAI Python library in your applications.
+
+For desktop environments with a browser, access https://chat.openai.com directly.
+
+**Alternative Approach - Snap (if desktop environment is installed)**:
+
+Amazon Linux does not natively support Snap. If you require a desktop wrapper and have EPEL configured:
+
+First, enable EPEL (Extra Packages for Enterprise Linux):
+
+```bash
+sudo dnf install -y epel-release
+```
+
+Snap support on Amazon Linux requires additional configuration that may not be officially supported. The recommended approach is to use the web interface or API.
+
+**Alternative Approach - AppImage (if desktop environment is installed)**:
+
+Download and run the third-party ChatGPT AppImage:
+
+```bash
+# Download the AppImage (third-party, not from OpenAI)
+curl -L -o /tmp/ChatGPT.AppImage "https://github.com/lencx/ChatGPT/releases/download/v1.1.0/ChatGPT_1.1.0_linux_x86_64.AppImage.tar.gz"
+tar -xzf /tmp/ChatGPT.AppImage -C /tmp
+chmod +x /tmp/ChatGPT_1.1.0_linux_x86_64.AppImage
+mv /tmp/ChatGPT_1.1.0_linux_x86_64.AppImage /usr/local/bin/chatgpt-desktop
+```
+
+**Security Warning**: This is a third-party application. Only download from the official repository at https://github.com/lencx/ChatGPT/releases.
+
+#### Verification
+
+For API installation, verify the OpenAI library:
+
+```bash
+python3 -c "import openai; print(openai.__version__)"
+```
+
+For AppImage installation:
+
+```bash
+/usr/local/bin/chatgpt-desktop --version
+```
+
+#### Troubleshooting
+
+**Problem**: No graphical display available
+
+**Solution**: Amazon Linux is typically a server OS. Use the ChatGPT API instead:
+
+```bash
+pip3 install --quiet openai
+```
+
+**Problem**: AppImage fails with "FUSE not available"
+
+**Solution**: Install FUSE:
+
+```bash
+sudo dnf install -y fuse fuse-libs
+```
+
+Or extract and run the AppImage directly:
+
+```bash
+/usr/local/bin/chatgpt-desktop --appimage-extract
+./squashfs-root/AppRun
+```
+
+**Problem**: Browser not available on headless server
+
+**Solution**: For headless environments, use the OpenAI API programmatically or set up X11 forwarding to access a browser from a remote machine.
+
+---
+
+### Windows (winget)
+
+#### Prerequisites
+
+- Windows 10 version 17763.0 or later, or Windows 11
+- winget package manager (pre-installed on Windows 10 1809+ and Windows 11)
+- Administrator privileges recommended
+- Active internet connection
+
+#### Installation Steps
+
+Run the following command in an Administrator PowerShell or Command Prompt to install the official OpenAI ChatGPT desktop app from the Microsoft Store:
+
+```powershell
+winget install --id 9NT1R1C2HH7J --source msstore --silent --accept-package-agreements --accept-source-agreements
+```
+
+This command:
+- `--id 9NT1R1C2HH7J` - Specifies the Microsoft Store ID for the official ChatGPT app
+- `--source msstore` - Installs from the Microsoft Store
+- `--silent` - Runs without user prompts
+- `--accept-package-agreements` - Automatically accepts package license agreements
+- `--accept-source-agreements` - Automatically accepts source license agreements
+
+#### Verification
+
+Open a new PowerShell or Command Prompt window (required for Start Menu to update), then verify the installation:
+
+```powershell
+winget list --id 9NT1R1C2HH7J
+```
+
+Or launch the application:
+
+```powershell
+start ChatGPT:
+```
+
+Alternatively, search for "ChatGPT" in the Start Menu.
+
+#### Troubleshooting
+
+**Problem**: `winget: The term 'winget' is not recognized`
+
+**Solution**: winget may not be installed or PATH may not be updated. Install App Installer from the Microsoft Store:
+
+```powershell
+start ms-windows-store://pdp/?productid=9NBLGGH4NNS1
+```
+
+After installation, open a new terminal window.
+
+**Problem**: Installation fails with "No applicable installer found"
+
+**Solution**: Your Windows version may be too old. Check your version:
+
+```powershell
+winver
+```
+
+Windows 10 version 17763.0 (October 2018 Update) or later is required.
+
+**Problem**: "Administrator privileges required"
+
+**Solution**: Right-click PowerShell or Command Prompt and select "Run as administrator", then retry the installation command.
+
+**Problem**: Microsoft Store is disabled by group policy
+
+**Solution**: Contact your IT administrator. For enterprise environments, the app can be deployed via Microsoft Intune or other MDM solutions.
+
+---
+
+### WSL (Ubuntu)
+
+#### Prerequisites
+
+- Windows Subsystem for Linux with Ubuntu installed
+- WSL 2 recommended for best performance
+- Desktop environment configured in WSL (optional, for GUI apps)
+- sudo privileges within WSL
+
+**Important**: ChatGPT desktop applications are GUI-based and require a display. WSL 2 with WSLg (Windows 11) supports Linux GUI applications natively. For WSL on Windows 10, additional X server configuration is required.
+
+#### Installation Steps
+
+**Recommended Approach - Use Windows ChatGPT App**:
+
+The simplest approach is to install the ChatGPT app on Windows (see Windows section above) and access it from WSL by launching Windows applications:
+
+```bash
+/mnt/c/Users/$USER/AppData/Local/Microsoft/WindowsApps/ChatGPT.exe &
+```
+
+Or access the web interface:
+
+```bash
+wslview https://chat.openai.com
+```
+
+**Note**: `wslview` opens URLs in the default Windows browser. Install it with:
+
+```bash
+sudo DEBIAN_FRONTEND=noninteractive apt-get update -y && sudo DEBIAN_FRONTEND=noninteractive apt-get install -y wslu
+```
+
+**Alternative Approach - Linux Snap in WSL (WSL 2 + WSLg required)**:
+
+For WSL 2 on Windows 11 with WSLg, you can run Linux GUI applications natively:
+
+First, ensure systemd is enabled in WSL. Edit `/etc/wsl.conf`:
+
+```bash
+sudo tee /etc/wsl.conf > /dev/null << 'EOF'
+[boot]
+systemd=true
+EOF
+```
+
+Restart WSL from PowerShell:
+
+```powershell
+wsl --shutdown
+```
+
+Then reopen WSL and install snapd:
+
+```bash
+sudo DEBIAN_FRONTEND=noninteractive apt-get update -y && sudo DEBIAN_FRONTEND=noninteractive apt-get install -y snapd
+sudo snap install chatgpt-desktop
+```
+
+#### Verification
+
+For the Windows app approach:
+
+```bash
+wslview https://chat.openai.com
+```
+
+This should open ChatGPT in your Windows browser.
+
+For the Linux snap approach (WSL 2 + WSLg):
+
+```bash
+snap list chatgpt-desktop
+```
+
+Launch the application:
+
+```bash
+chatgpt-desktop &
+```
+
+#### Troubleshooting
+
+**Problem**: GUI applications do not display
+
+**Solution**: WSLg requires Windows 11 or later. For Windows 10, install an X server like VcXsrv:
+
+1. Install VcXsrv on Windows
+2. Launch XLaunch with "Multiple windows" and "Disable access control"
+3. In WSL, set the display:
+
+```bash
+export DISPLAY=$(grep nameserver /etc/resolv.conf | awk '{print $2}'):0.0
+```
+
+**Problem**: systemctl commands fail
+
+**Solution**: systemd may not be enabled. Edit `/etc/wsl.conf` as shown above and restart WSL.
+
+**Problem**: Snap installation hangs
+
+**Solution**: Snap may have issues in WSL. Use the Windows ChatGPT app or web interface instead:
+
+```bash
+wslview https://chat.openai.com
+```
+
+**Problem**: `wslview: command not found`
+
+**Solution**: Install wslu utilities:
+
+```bash
+sudo DEBIAN_FRONTEND=noninteractive apt-get update -y && sudo DEBIAN_FRONTEND=noninteractive apt-get install -y wslu
+```
+
+---
+
+### Git Bash (Windows)
+
+#### Prerequisites
+
+- Windows 10 version 17763.0 or later, or Windows 11
+- Git Bash installed (comes with Git for Windows)
+- ChatGPT installed on Windows (see Windows section above)
+
+**Note**: Git Bash on Windows runs within the Windows environment and inherits the Windows PATH. Once ChatGPT is installed on Windows, it is accessible from Git Bash through Windows application launching.
+
+#### Installation Steps
+
+Git Bash itself cannot install Windows applications directly. Install the ChatGPT Windows app using one of these methods:
+
+**Method 1 - Use winget from Git Bash**:
+
+Git Bash can execute Windows commands. Run the winget installation:
+
+```bash
+winget.exe install --id 9NT1R1C2HH7J --source msstore --silent --accept-package-agreements --accept-source-agreements
+```
+
+**Method 2 - Use PowerShell from Git Bash**:
+
+```bash
+powershell.exe -Command "winget install --id 9NT1R1C2HH7J --source msstore --silent --accept-package-agreements --accept-source-agreements"
+```
+
+After installation, close and reopen Git Bash for Start Menu shortcuts to update.
+
+#### Verification
+
+Verify ChatGPT is installed by checking winget:
+
+```bash
+winget.exe list --id 9NT1R1C2HH7J
+```
+
+Launch ChatGPT from Git Bash:
+
+```bash
+start ChatGPT:
+```
+
+Or open the web interface:
+
+```bash
+start https://chat.openai.com
+```
+
+#### Troubleshooting
+
+**Problem**: `winget.exe: command not found`
+
+**Solution**: winget may not be in the Git Bash PATH. Use the full path:
+
+```bash
+/c/Users/$USER/AppData/Local/Microsoft/WindowsApps/winget.exe install --id 9NT1R1C2HH7J --source msstore --silent --accept-package-agreements --accept-source-agreements
+```
+
+**Problem**: `start: command not found`
+
+**Solution**: In Git Bash, use `cmd.exe` to run Windows commands:
+
+```bash
+cmd.exe /c start ChatGPT:
+```
+
+**Problem**: Installation fails with permission errors
+
+**Solution**: Git Bash may need to be run as Administrator. Right-click Git Bash and select "Run as administrator", then retry the installation.
+
+**Problem**: ChatGPT app installed but cannot launch from Git Bash
+
+**Solution**: Use the Windows `start` command through cmd:
+
+```bash
+cmd.exe /c start "" "ChatGPT:"
+```
+
+Or simply access the web interface:
+
+```bash
+cmd.exe /c start https://chat.openai.com
+```
+
+---
+
+## Post-Installation Configuration
+
+### First-Time Setup
+
+After installing and launching ChatGPT on any platform:
+
+1. **Sign in** - Log in with your OpenAI account (email/password, Google, Microsoft, or Apple ID)
+2. **Enable keyboard shortcut** - The app registers a global keyboard shortcut:
+   - macOS: `Option + Space`
+   - Windows: `Alt + Space`
+3. **Grant permissions** - If using voice features, grant microphone access when prompted
+4. **Enable memory** (optional) - Go to Settings > Personalization to enable memory features
+
+### Keyboard Shortcuts
+
+| Platform | Quick Launch | New Chat | Show/Hide Window |
+|----------|-------------|----------|------------------|
+| macOS | Option + Space | Cmd + N | Option + Space |
+| Windows | Alt + Space | Ctrl + N | Alt + Space |
+
+### Configuring Voice Features
+
+To use Advanced Voice mode:
+
+1. Open ChatGPT settings
+2. Navigate to Voice settings
+3. Select your preferred voice
+4. Grant microphone permissions when prompted
+
+---
+
+## Common Issues
+
+### Issue: App Requires Paid Subscription for Features
+
+**Symptoms**: Certain features like Advanced Voice, GPT-4, or file uploads are unavailable.
+
+**Solution**: Some features require ChatGPT Plus, Team, or Enterprise subscriptions. Free tier users have access to basic features. Visit https://chat.openai.com/upgrade to view subscription options.
+
+### Issue: Conversation History Not Syncing
+
+**Symptoms**: Conversations on desktop do not appear on mobile or web, or vice versa.
+
+**Solution**: Ensure you are signed into the same OpenAI account across all devices. Check your internet connection. Try signing out and back in:
+
+1. Open ChatGPT settings
+2. Sign out
+3. Sign back in with your account
+
+### Issue: High CPU or Memory Usage
+
+**Symptoms**: The ChatGPT app consumes excessive system resources.
+
+**Solution**: This can occur with long conversations or multiple windows. Close unused conversations or restart the app. On macOS:
+
+```bash
+killall ChatGPT
+open -a ChatGPT
+```
+
+On Windows:
+
+```powershell
+taskkill /IM ChatGPT.exe /F
+start ChatGPT:
+```
+
+### Issue: Keyboard Shortcut Does Not Work
+
+**Symptoms**: Pressing Option+Space (macOS) or Alt+Space (Windows) does not open ChatGPT.
+
+**Solution**:
+
+1. Ensure ChatGPT is running (check system tray/menu bar)
+2. Another application may be using the same shortcut. Check System Settings/Preferences for conflicting shortcuts
+3. Restart the ChatGPT application
+
+### Issue: Cannot Upload Files
+
+**Symptoms**: File upload button is disabled or uploads fail.
+
+**Solution**:
+
+1. Ensure you have an active internet connection
+2. Check file size limits (varies by subscription tier)
+3. Verify the file format is supported (images, PDFs, code files, etc.)
+4. Free tier users have limited file upload capabilities
+
+### Issue: "Unable to Connect" Error
+
+**Symptoms**: The app shows connection errors and cannot communicate with OpenAI servers.
+
+**Solution**:
+
+1. Check your internet connection
+2. Verify OpenAI services are operational at https://status.openai.com
+3. Check if a firewall or proxy is blocking the connection
+4. Try accessing https://chat.openai.com in a browser to isolate the issue
+
+---
+
+## References
+
+- [ChatGPT Desktop Official Page](https://openai.com/chatgpt/desktop/)
+- [ChatGPT Download Page](https://openai.com/chatgpt/download/)
+- [ChatGPT macOS App System Requirements](https://help.openai.com/en/articles/9395554-what-are-the-system-requirements-for-the-chatgpt-macos-app)
+- [Using the ChatGPT Windows App](https://help.openai.com/en/articles/9982051-using-the-chatgpt-windows-app)
+- [Windows App Release Notes](https://help.openai.com/en/articles/10003026-windows-app-release-notes)
+- [ChatGPT Homebrew Cask](https://formulae.brew.sh/cask/chatgpt)
+- [ChatGPT on Microsoft Store](https://apps.microsoft.com/detail/9nt1r1c2hh7j)
+- [ChatGPT Desktop Snap Package](https://snapcraft.io/chatgpt-desktop)
+- [lencx/ChatGPT Third-Party Desktop App](https://github.com/lencx/ChatGPT) (Unofficial)
+- [OpenAI Status Page](https://status.openai.com)