wtf is supergrok-zed?

This repository is a local connector that lets the Zed code editor talk to xAI's Grok models through a SuperGrok subscription. Zed's built in support for OpenAI style APIs normally expects to talk to OpenAI directly, so this project runs a small server on your own computer that intercepts those requests and forwards them to xAI instead. The server listens on your machine at address 127.0.0.1 on port 8787. It relabels model names, so typing supergrok actually calls the grok-4.5 model, and it adds the correct login credentials before sending chat requests to xAI's servers. It supports both regular replies and streaming replies, where the answer appears piece by piece as it is generated. There are two ways to authenticate, and only one is active at a time. The first uses an API key from xAI's developer console, billed per token used. The second, called OAuth mode, lets you sign in with your SuperGrok or X Premium subscription through a companion menu bar app for Mac, so usage counts against that subscription instead of being billed per token. OAuth sign in currently only works through the Mac app, not from the command line. Setup requires Python 3.12 or newer along with a tool called uv for managing the Python environment. After installing, you run one command to write a default configuration file and another to start the server, then point Zed's OpenAI provider setting at the local server address. The connector can run alongside Zed's own built in xAI provider without conflict. For Mac users who prefer a graphical interface, the project also includes a native menu bar app written in Swift. It can sign in, store your key or tokens securely in the Mac Keychain, edit the configuration file for you, and automatically start and stop the background connector process. Building the app requires Xcode and a couple of extra developer tools. The whole project is released under the MIT license.