A macOS overlay application for pinning chat.a8c.com to a dedicated window with a customizable global keyboard shortcut.
macOS 10.15+ • Universal Binary (Intel & Apple Silicon)
Click the button above to download the latest version
- Dedicated floating window for chat.a8c.com
Control+Spaceglobal keyboard shortcut to show/hide (customizable)- Menu bar icon for quick access
- Automatically saves window position and size
- Open LibreChat from anyplace
- Light/Dark mode adaptive menu bar icon
- Remembers your last prompt and conversation
- Easy access to all the available agents
This is the easiest way to install if you don't have Homebrew or prefer not to use the Terminal.
Click the button above or
click here to download
.
|
Move.to.aplications.folder.mp4 |
Developer.can.not.be.verified.mp4 |
|
|
Open.Anyway.mp4 |
|
The app needs Accessibility permissions to detect your keyboard shortcut. When you first open the app:
|
Accessibility.Settings.mp4 |
|
The overlay now uses WordPress.com SSO for authentication. Here's what to expect:
|
|
The overlay reads your browser's cookies to import the session. For Chrome-based browsers, macOS will show a Keychain access prompt asking for your password — this is normal and expected. The overlay needs to decrypt your browser's cookies to import your sign-in session. Click Allow (or Always Allow to avoid the prompt in the future).
Firefox users will not see this prompt, as Firefox stores cookies without encryption.
Having issues with sign-in? Post on the LibreChat A8C Overlay P2 and we'll help you out.
|
Press Control+Space anywhere on your Mac to show or hide the chat overlay. |
Shortcut.Working.mp4 |
For users comfortable with the Terminal, Homebrew provides automatic updates.
Open Terminal and run the following commands:
# Add the tap (only needed once)
brew tap automattic/chat-a8c-overlay
# Install the app
brew install --cask macos-a8c-chat-overlayAfter running these commands, it should look something like this:
The app will try to open automatically, but macOS will block it:
- Open System Settings > Privacy & Security
- Scroll down to the Security section
- Click Open Anyway next to the LibreChat A8C Overlay message
- Authenticate with Touch ID or your password
When the app opens, it will prompt you to grant Accessibility permissions:
- Click Open System Settings in the dialog
- Toggle ON the switch for LibreChat A8C Overlay
- The app will detect this and prompt you to restart
- Click Restart Now
The overlay will open your default browser for WordPress.com authentication. Sign in there, then click the "I've signed in" button in the overlay. See Step 6 in the Direct Download instructions above for detailed tips.
| Action | How |
|---|---|
| Show/Hide Window | Press Control+Space anywhere |
| Access Menu | Click the flame icon in the menu bar |
| Set Custom Shortcut | Menu bar > Set New Trigger |
| Auto-Start at Login | Menu bar > Install Autolauncher |
| Quit the App | Menu bar > Quit |
Don't like Control+Space? You can set your own shortcut:
- Click the menu bar icon
- Select Set New Trigger
- Press your desired key combination (e.g.,
Command+Shift+C) - The new shortcut is saved automatically
- Download the latest version from the button at the top of this page
- Replace the old app in your Applications folder with the new one
- Re-grant Accessibility permissions if prompted
brew upgrade --cask macos-a8c-chat-overlay- Quit the app from the menu bar
- Drag
LibreChat A8C Overlay.appfrom Applications to the Trash - Optionally, remove preferences:
rm -rf ~/Library/Logs/macos-a8c-chat-overlay rm -f ~/Library/Preferences/com.automattic.librechat-a8c-overlay.plist
# Standard uninstall
brew uninstall --cask macos-a8c-chat-overlay
# Complete removal (including preferences and logs)
brew uninstall --cask --zap macos-a8c-chat-overlay- macOS 10.15 (Catalina) or later
- Works only while connected to Automattic's proxy/VPN
This can happen if the download was interrupted or the app wasn't properly signed. Try:
xattr -cr /Applications/LibreChat\ A8C\ Overlay.appThen try opening the app again.
-
Check Accessibility permissions:
- Go to System Settings > Privacy & Security > Accessibility
- Make sure LibreChat A8C Overlay is in the list and enabled
-
Try removing and re-adding the permission:
- Click the
-button to remove the app - Click the
+button and add it again from Applications - Restart the app
- Click the
-
Restart the app:
- Quit from the menu bar
- Open the app again
-
Check for conflicts:
- Another app might be using the same shortcut
- Try setting a different shortcut via Menu bar > Set New Trigger
- Check if the app is running in Activity Monitor
- Try quitting and reopening the app
- Make sure you're not in full-screen mode (some full-screen apps hide menu bar icons)
- Make sure you're signed in to chat.a8c.com in your browser before clicking the button
- Wait 5-10 seconds after signing in — your browser needs time to save cookies to disk
- Try clicking "I've signed in" again — it may take 2-3 attempts on the first sign-in
- Chrome/Brave/Edge users: If macOS asks for your password to access the Keychain, click Allow. This is required to read your browser's session cookies.
- If using Chrome, try closing any open
chat.a8c.comtabs in the browser, then click the button - Safari is not supported as the authentication browser. Use Chrome, Firefox, Brave, or Edge.
- As a last resort, quit the overlay app completely and reopen it
- Make sure you're connected to Automattic's proxy/VPN
- Try refreshing: Menu bar > Show, then close and reopen
For developers who want to build from source:
git clone https://github.com/Automattic/homebrew-chat-a8c-overlay.git
cd homebrew-chat-a8c-overlay/dmg-builder
./test_build.shThe built .app will be in dmg-builder/dist/.
- Based on macos-grok-overlay by tchlux
- Uses the LibreChat flame logo
See CHANGELOG.md for a detailed list of changes in each version.