selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Grok UI logo

Self-host Grok UI

v0.14.0

Local-first dashboard for Grok Build sessions

BetaOpen SourceMIT
Updated2 weeks ago
LanguageTypescript
Setup difficultyModerate
MobileResponsive
Stars
141
Ports
4310 (Dashboard API and SSE), 4311 (Host agent)
Requires
Grok Build CLI, Node.js
Install with NPM
Grok UI Event Horizon dashboard showing all product areas with Privacy Mode enabled

What is Grok UI?

Should you self-host Grok UI?

Grok UI scores 46/100 on selfhost.directory (how scoring works) and ranks #104 of 166 in Developer Tools. It has 141 GitHub stars.

It shipped 9 stable releases in the past year. The latest, v0.14.0, came out on 12 October 2026. New versions land roughly every 2 days.

Setup is moderate: expect some configuration beyond a single command. It is MIT-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is openhands (87/100, 92 105 stars). It scores higher overall, so compare the two before you pick. See Grok UI vs openhands side by side.

Features

  • Cross-session workflow command field
  • Live Git change inspection
  • Live runtime monitoring
  • Multi-machine fleet monitoring
  • Native session control via ACP
  • No analytics or telemetry
  • Privacy mode
  • Runtime intelligence
  • Secure remote sessions
  • Session Console per agent
  • Session previews
  • Three built-in themes
  • Usage ledger with budgets

Grok UI README

How to install Grok UI

Install Grok UI with NPM

Environment variables
HOST, PORT, GROK_HOME, GROK_BIN, GROK_UI_TOKEN, GROK_UI_STATE_DIR, GROK_UI_AGENT_TOKEN, GROK_UI_AGENT_CONTROL_TOKEN, GROK_UI_AGENT_HOST, GROK_UI_AGENT_PORT, GROK_UI_AGENT_LABEL

npx --yes grok-ui

One-command launch that checks environment, starts the local server, and opens the dashboard. Also supports `npx --yes grok-ui doctor` for diagnostics and `npx --yes grok-ui agent` for host agent mode.

How to configure Grok UI

  • GROK_BINgrokGrok executable used by the ACP controller

    Grok executable used by the ACP controller

  • GROK_HOME~/.grokGrok state directory

    Grok state directory

  • GROK_UI_AGENT_CONTROL_TOKENemptyOptional, distinct token that enables secure remote sessions on the host

    Optional, distinct token that enables secure remote sessions on the host

  • GROK_UI_AGENT_HOST127.0.0.1Host-agent bind interface

    Host-agent bind interface

  • GROK_UI_AGENT_LABELsystem hostnameOptional host label advertised by the agent

    Optional host label advertised by the agent

  • GROK_UI_AGENT_PORT4311Host-agent port

    Host-agent port

  • GROK_UI_AGENT_TOKENemptyRequired dedicated bearer token for host-agent mode

    Required dedicated bearer token for host-agent mode

  • GROK_UI_STATE_DIR~/.grok-uiPrivate annotations and managed-session state

    Private annotations and managed-session state

  • GROK_UI_TOKENemptyRequired for non-loopback binding

    Required for non-loopback binding

  • HOSTloopbackAPI bind interface

    API bind interface

  • PORT4310API port

    API port

Grok UI releases & version history

More in Dashboard

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…