Mac menubar app

Embeds the official ChatGPT web interface in an Electron-based menubar application accessible via Cmd+Shift+G (Mac) or Ctrl+Shift+G (Windows). Uses the 'menubar' npm package to create a native system tray icon that spawns a BrowserWindow containing a webview pointing to chat.openai.com, with window visibility toggled by keyboard shortcut registration via Electron's globalShortcut API. The main process manages window lifecycle, focus state, and tray interactions while the renderer process loads the ChatGPT web interface directly.

Registers platform-specific global keyboard shortcuts (Cmd+Shift+G on macOS, Ctrl+Shift+G on Windows) using Electron's globalShortcut API in the main process. The shortcut handler toggles the menubar window visibility state — if the window is visible and focused, it hides; if hidden or unfocused, it shows and brings to foreground. This is implemented in index.js as a synchronous event listener that executes regardless of which application currently has focus.

Provides right-click context menu functionality within the ChatGPT webview using the 'electron-context-menu' npm package. This package automatically injects a native context menu (cut, copy, paste, inspect element, etc.) into the webview, matching the OS's native context menu appearance and behavior. The implementation requires minimal configuration — the package hooks into Electron's webContents events to intercept right-click events and render the appropriate menu based on the clicked element type (text, link, image, etc.).

Builds and distributes separate native application binaries for macOS ARM64 (Apple Silicon M1/M2) and x64 (Intel) architectures using Electron Forge. The build configuration in package.json specifies two distinct build targets that compile the Electron app into architecture-specific .dmg installer files. Each DMG contains a native executable optimized for its target architecture, avoiding the performance overhead of running Intel binaries under Rosetta 2 translation on Apple Silicon Macs. Distribution occurs via GitHub releases, with users downloading the appropriate DMG based on their Mac's architecture.

Implements automatic update checking and installation using the 'update-electron-app' npm package, which wraps Electron's built-in update functionality. The package periodically checks GitHub releases for new versions and, when an update is available, prompts the user to download and install it. The update process downloads the new .dmg file, verifies its integrity, and restarts the application with the updated binary. This is configured in the main process with minimal code — typically a single require() statement that handles the entire update lifecycle.

Collects anonymous usage analytics using the 'nucleus-analytics' npm package, which tracks application events (launches, feature usage, crashes) and sends aggregated data to Nucleus servers. The package is initialized in the main process and automatically instruments Electron lifecycle events without requiring explicit event tracking code. Analytics data is sent in batches over HTTPS and includes metadata like OS version, app version, and session duration, but excludes user-identifiable information or conversation content.

Embeds the official OpenAI ChatGPT web interface (chat.openai.com) directly in an Electron BrowserWindow using the webview tag. The renderer process (index.html) loads the ChatGPT URL into a webview with preload scripts and context isolation disabled to allow full web functionality. This approach preserves all ChatGPT web features (plugins, file uploads, vision capabilities, real-time updates) without requiring API integration or custom UI implementation. The webview operates in a sandboxed context but with sufficient permissions to interact with the ChatGPT web interface.

Manages the menubar window lifecycle in the main process (index.js) using Electron's BrowserWindow and Menu APIs. The main process creates a single BrowserWindow on application startup, registers event listeners for window focus/blur/close events, and implements visibility toggling logic triggered by the global keyboard shortcut or tray icon clicks. Window state (visible/hidden, focused/unfocused) is tracked in memory and used to determine whether the shortcut should show or hide the window. The implementation uses Electron's 'before-quit' event to handle graceful shutdown and prevent data loss.