explaingit

andypduk/supergrok-zed

Analysis updated 2026-05-18

★ 1SwiftAudience · developerComplexity · 2/5LicenseSetup · moderate

TLDR

A local proxy server that lets the Zed editor use xAI's Grok models via a SuperGrok subscription or API key, instead of OpenAI.

Mindmap

mindmap
  root((supergrok-zed))
    What it does
      Local proxy server
      Connects Zed to xAI
      Rewrites model names
    Tech stack
      Swift
      Python
      uv
    Auth modes
      API key billing
      OAuth subscription
    Use cases
      Use SuperGrok in Zed
      Local model aliasing
    Audience
      Zed editor users
      xAI subscribers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Use your existing SuperGrok or X Premium subscription inside Zed instead of paying per token.

USE CASE 2

Run Grok models locally through Zed's OpenAI provider without changing Zed's core settings.

USE CASE 3

Set custom model name aliases so typing a short name like supergrok calls a specific Grok model.

What is it built with?

SwiftPythonuvxAI API

How does it compare?

andypduk/supergrok-zedaakarsh-goyal/macjuicealtuzar/sonicflow
Stars111
LanguageSwiftSwiftSwift
Setup difficultymoderateeasyeasy
Complexity2/51/52/5
Audiencedevelopergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires an xAI API key or a SuperGrok subscription plus Python 3.12+ and uv.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

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.

Copy-paste prompts

Prompt 1
Walk me through installing Python 3.12 and uv so I can run supergrok-zed.
Prompt 2
Help me write the config.toml for supergrok-zed with auth_mode set to api_key.
Prompt 3
Show me how to merge the Zed settings.json snippet for supergrok-zed into my existing settings.
Prompt 4
Explain the difference between api_key mode and oauth mode in supergrok-zed and which one I should use.

Frequently asked questions

What is supergrok-zed?

A local proxy server that lets the Zed editor use xAI's Grok models via a SuperGrok subscription or API key, instead of OpenAI.

What language is supergrok-zed written in?

Mainly Swift. The stack also includes Swift, Python, uv.

What license does supergrok-zed use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is supergrok-zed to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is supergrok-zed for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.

Alternatives & similar repos