Warp is a secondary-sidebar coding agent for VS Code and Cursor.
It talks to the Grok Build / Grok CLI agent over ACP (stdio), with chat UI, tools, slash commands, and your existing Grok account.
Features
- Chat in the right secondary sidebar
- Grok OAuth sign-in (same
~/.grok/auth.jsonas the TUI) - Streaming replies, thinking blocks, and tool activity
- Model + reasoning effort picker
- Slash commands (
/) with autocomplete — Grok builtins, skills, and Warp actions - Compact context, export/copy chat, session history
- Attach images/files,
@workspace mentions, prompt queue - Permission modes: ask (default) or yolo (
/always-approve)
Requirements
- VS Code ≥ 1.85 or Cursor (recent)
- Grok CLI / Grokfork binary that supports
agent … stdio(ACP)- Official Grok Build install, or a fork binary such as
grokfork - Must be on your
PATH, or set Warp: Binary Path in settings
- Official Grok Build install, or a fork binary such as
- A Grok / xAI account for live chat
Warp does not embed the agent binary. Install Grok Build (or your fork) first.
Binary auto-detect order
- Setting
warp.binaryPath grokfork/grokonPATH- Common locations, e.g.
~/.grok/bin/grok~/bin/grokfork(Windows:%USERPROFILE%\bin\grokfork.exe)
Install
Install (public download — no local files required)
One command (downloads the VSIX from GitHub Releases):
code --install-extension https://github.com/warpte-labs/warp/releases/latest/download/warp-0.8.4.vsix
cursor --install-extension https://github.com/warpte-labs/warp/releases/latest/download/warp-0.8.4.vsix
Or download from the latest release → Extensions → Install from VSIX…
Then reload → open the project folder you want Grok to work in → Warp: Open Chat → Continue with Grok.
From source (developers only)
git clone https://github.com/warpte-labs/warp.git
cd warp
npm install
npm run compile
npm run package
Quick start
| Action | How |
|---|---|
| Open chat | Command Palette → Warp: Open Chat |
| Sign in | Footer Sign in, or Warp: Sign In |
| Slash commands | Type / or press the / toolbar button |
| New chat | Top + or /new |
| Compact context | /compact or click the usage bar |
| Export chat | /export |
| Toggle YOLO tools | Footer ask / yolo, or /always-approve |
| Restart agent | Warp: Restart Agent |
Settings
| Setting | Default | Description |
|---|---|---|
warp.binaryPath |
"" |
Absolute path to grok / grokfork. Empty = auto-detect |
warp.alwaysApprove |
false |
Skip tool permission prompts (--always-approve) |
warp.mockMode |
false |
UI-only mock replies (no agent process) |
Open Settings and search for Warp.
Security notes
- Ask mode (default) may prompt when the agent wants to run tools.
- Yolo / always-approve lets the agent run tools without prompts — only enable if you trust the workspace.
- Auth tokens live in
~/.grok/auth.json(managed by the Grok CLI), not in the extension package. - The extension spawns a local child process; it does not send your code to third-party servers itself — the Grok agent talks to xAI APIs per your account.
Slash commands (highlights)
Warp-handled: /new, /compact, /export, /copy, /model, /effort, /always-approve, /resume, /history, /rename, /login, /logout, /multiline
Passed to the agent: /context, /plan, skills (/review, /help, plugins, …) — whatever your Grok install advertises.
Development
npm install
npm run compile
npm run watch # rebuild on change
npm run package # produce warp-*.vsix
npm run sync:marked # refresh webview marked bundle
Press F5 in VS Code with this folder open to launch an Extension Development Host (if you add a launch config).
License
MIT. The extension package includes a LICENSE file.
Disclaimer
Warp is an independent community extension. It is not an official product of xAI, Warp.dev, or VS Code. “Grok†and related marks belong to their owners.