⚒️ Grok Forge — the unofficial Grok app for VS Code
Forge whatever you decide you want to make. Images through Imagine. Code through
Grok Build. All from friendly chat tabs in VS Code — running on your own Grok
subscription, with the terminal kept completely out of sight.
Unofficial. Grok Forge is a community project and is not affiliated with,
endorsed by, or supported by xAI. "Grok" is a trademark of xAI. This extension is
simply a friendly window onto the official Grok Build CLI that you install and sign
into yourself.
🆕 What's new in 0.6
Creative power. Click any generated image and its exact generation prompt appears
beneath it — captions matched at creation time, so they can't lie — with ‹ › arrows
to flip through the batch. Galleries are now per-batch and hand you back to the chat
when you type a new request. The chat renders real markdown (bold, lists, tables,
code) live while Grok streams, long code arrives as collapsible blocks with a
"Show more" button, and links are clickable. And Send stays live while Grok works:
your next message waits in a queue and fires the moment the turn ends — hit Stop and a
queued message is held safe (Send now / Copy / Discard), never destroyed. Full history
on the Changelog tab (or CHANGELOG.md).
What you get
- 💬 Multi-chat in real editor tabs — the anvil icon opens a sidebar hub; start a
new chat or reopen a past one and it opens as its own editor tab. Live streaming
responses, a model picker, and a
chat · plan · build · imagine cue so you always
know what Grok is set up to do.
- 🗂️ Local chat history — conversations are saved on your machine; reopen or delete
them from the sidebar hub. Nothing leaves your device.
- 🎨 A real image workflow — ask Grok to imagine something and results arrive as
compact cards. Click an image to expand it with its exact generation prompt beneath
it and ‹ › arrows to flip through the batch; refine the one you're viewing from
right there. Each card opens its own per-batch gallery. Right-click any image for
Copy / Save As… / Open / Show in Finder / Save to assets/ (with optional ASSETS.md
logging for license tracking). Images are detected from disk, so it works no matter
how Grok phrases its output.
- 📎 Attach & paste — attach files to a message, paste a screenshot straight from the
clipboard, and click any image to expand it in a lightbox.
- ⏱️ Never looks frozen — a live "Grok is working… Ns" timer that settles into
"took Ns" when the turn finishes.
- 🔐 Your subscription, your machine — everything runs through the official Grok
Build CLI locally. No keys to paste, no third-party servers in between.
- 🛡️ Real permission prompts — when Grok wants to act, you get big Allow/Deny
buttons (or flip on auto-approve in settings if you like to live fast).
- ♿ Accessibility-first — large click targets, high contrast, dictation button,
zero drag-and-drop, zero required keyboard shortcuts. Designed from day one for
single-click (including BCI) use.
Getting started
- Install this extension.
- Click the ⚒️ anvil icon in the activity bar.
- No Grok Build CLI yet? The welcome screen installs it for you — one button runs the
official installer (
curl -fsSL https://x.ai/cli/install.sh | bash), another runs
grok login so you can sign in with your subscription.
- Click New chat in the hub — it opens as an editor tab. Chat, imagine, forge.
Settings
| Setting |
What it does |
grokForge.grokPath |
Path to the grok binary (blank = $GROK_CLI_PATH or ~/.grok/bin/grok) |
grokForge.model |
Default model for new sessions |
grokForge.permissionMode |
ask (Allow/Deny buttons, default) or auto-approve |
How it works
Grok Forge speaks the Agent Client Protocol (ACP) to a persistent grok agent stdio
session — the same architecture the official Claude Code and Zed integrations use to
talk to their CLIs. The extension is a thin, friendly cockpit; the CLI does the flying.
License
MIT. Not affiliated with xAI — see the disclaimer above.
