Warp
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.json as 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
- 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 / grok on PATH- 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.
