Skip to content

Grok – Native macOS Overlay for Grok AI | © 2025 Sumit Duster Elevate your Grok AI experience with Grok, the intuitive native overlay that brings xAI's powerful Grok directly to your Mac desktop. Press Space to summon Grok anywhere, anytime—whether you're coding, researching, or brainstorming.

License

Notifications You must be signed in to change notification settings

sumitduster-iMac/Grok

Repository files navigation

Grok

A simple macOS overlay application for pinning grok.com to a dedicated window and key command option+space.

Launcher Sample

Installation:

The easiest approach is to download and execute the DMG installer (by clicking the image below) to place the program into your Applications folder.

Compatibility: The DMG launcher is now built as a universal binary (arm64 + x86_64), so it runs on both modern M-series laptops and older Intel-based Macs (2015/2017 era) provided they are on a supported version of macOS. When creating your own build you can force a specific target by exporting PY2APP_ARCH (e.g., PY2APP_ARCH=x86_64 ./dmg-builder/build.sh).

DMG Installer

Otherwise, you can install the latest stable release from a Terminal with:

python3 -m pip install macos-grok-overlay

Once you've installed the package, you can enable it to be automatically launched at startup with:

grok --install-startup

You will get a request like this to enable Accessibility the first time this launches.

Accessibility Request

The Accessibility access is required for the background task to listen for the Option+Space keyboard command. But please don't just take my word for it, look at the listener code yourself and see. ;)

Within a few seconds of approving Accessibility access, you should see a little icon like this appear along the top of your screen.

Menu Sample

And you're done! Now this should launch automatically and constantly run in the background. If you ever decide you do not want it, see the uninstall instructions below.

Usage

Once the application is launched, it should immediately open a window dedicated to grok.com. You'll need to log in there, but you should only need to do that once. After installing, pressing Option + Space while the window is open will hide it, and pressing it again at any point will reveal it and pin it as the top-most window overlay on top of other applications. This enables quick and easy access to Grok on macOS.

There is a dropdown menu with basic options that shows when you click the menubar icon. Personally I find that using Option + Space to summon and dismiss the dialogue as needed is the most convenient.

If you decide you want to uninstall the application, you can do that by clicking the option in the menubar dropdown, or from the command line with:

grok --uninstall-startup

About

Developed by Sumit Duster

A macOS overlay for Grok AI - providing quick access to Grok from anywhere on your Mac.

How it works

This is a very thin pyobjc application written to contain a web view of the current production Grok website. Most of the logic contained in this small application is for stylistic purposes, making the overlay shaped correctly, resizeable, draggable, and able to be summoned anywhere easily with a single (modifiable) keyboard command. There's also a few steps needed to listen specifically for the Option + Space keyboard command, which requires Accessibility access to macOS.

Final thoughts

This was a small fun weekend project. Please file issues and I'll be happy to adjust, but I also highly recommend you look at the source code yourself if you want to change something. It's a small and simple project, Grok (or similar) could easily help you modify it for your own purposes.

About

Grok – Native macOS Overlay for Grok AI | © 2025 Sumit Duster Elevate your Grok AI experience with Grok, the intuitive native overlay that brings xAI's powerful Grok directly to your Mac desktop. Press Space to summon Grok anywhere, anytime—whether you're coding, researching, or brainstorming.

Resources

License

Stars

Watchers

Forks

Sponsor this project

Packages

No packages published

Contributors 2

  •  
  •