Grok Build web
Browser UI for the grok CLI

Grok Build,
in your browser.

Run grok --web and drive Grok Build from a local chat UI — no TUI, no npm install, no build step.

Start on GitHub Read the docs
Zero npm deps Vanilla ES modules only
ACP bridge Agent Client Protocol
SSE streaming Live agent updates

How it works

HTTP in, ACP out.

A thin Node bridge spawns grok agent stdio and translates browser HTTP + Server-Sent Events into the Agent Client Protocol — the JSON-RPC surface Zed, Claude Code, and Codex already speak. 

# Data flow
browser  ──POST /prompt──▶  server.mjs  ──stdin──▶  grok agent stdio
browser  ◀──SSE /stream──   server.mjs  ◀──stdout──  grok agent stdio

Features

Everything the TUI does,
with room to breathe.

Streaming responses, tool cards, permissions, and project management — in one local web UI built for long sessions.

Real-time agent updates

SSE delivers thinking chunks, message streams, tool calls, and hook events as they happen. Reconnect with exponential backoff if the tab sleeps.

Rich tool rendering

Terminal output with ANSI colors, diffs, todos, browser actions, scheduler routines, and nested subagent disclosures — each with a purpose-built renderer.

Project drawer & workspaces

Sessions grouped by workspace. Switch projects from the topbar, resume recent sessions, or start fresh — each browser tab keeps its own isolated session.

Composer extras

Attach text files as fenced code blocks, use browser speech input, slash-command autocomplete, model picker, and headless one-shot modes for check and best-of-N runs.

Permissions & settings

Manual or auto-approve tool permissions. Settings panel respawns the agent with new launch flags — effort, sandbox, model, allow/deny rules, and more.

Quick start

Up and running in minutes.

  1. Authenticate once

    Install the grok CLI (Node 24+), then run grok login so the agent can reach your account.

  2. Launch from your project

    From any workspace directory, run grok --web. The bridge picks a free port and opens your browser.

  3. Or clone the repo

    Prefer the source tree? Clone grok-build-web and start node server.mjs yourself.

# Authenticate (once)
$ grok login

# From your project — recommended
$ grok --web

# Alternative: clone and run manually
$ git clone https://github.com/AppleLamps/grok-build-web.git
$ cd grok-build-web
$ node server.mjs

Compatibility

Runs where you already work.

Browsers Chrome, Firefox, Safari, Edge (current releases)
OS Windows, macOS, Linux
Runtime Node.js 24+ (native WebSocket / modern stdlib)
CLI grok installed and authenticated
Protocol Agent Client Protocol (ACP) over grok agent stdio
Editors Zed and other ACP-compatible clients use the same agent surface

Ready to try it?

Clone grok-build-web, run grok --web, and open the README for configuration details.

Get started Read the docs