GrokTerm icon GrokTerm
GrokTerm running on macOS — multi-tab terminal with Grok Build and voice

Multi-tab terminal host for Grok Build. Real PTY sessions, two-way Grok Voice, manager control plane. MCP-ready.

Standalone app

macOS terminal

Notarized GrokTerm.app — own window, Dock icon, Apple Silicon.

Download .dmg v0.1.7 · notarized · Apple Silicon

Link always serves the latest release (currently v0.1.7).

CLI install

One-liner

Installs grokterm to ~/.local/bin (macOS & Linux).

curl -fsSL https://raw.githubusercontent.com/daniel-farina/grokterm-releases/main/install.sh | bash

Then run grokterm · grokterm --voice · grokterm --grok

Latest release: v0.1.7

What it does

A terminal built around Grok Build, not a generic multiplexer.

Multi-tab PTYs

Shell and Grok Build sessions side by side, with readiness-aware delegation between them.

Grok Voice

Two-way voice dispatcher with tools for opening tabs, delegating work, closing tabs and changing settings.

Manager control plane

A manager panel that drives the whole host: type help, or let voice drive the same tools.

Project folders

Named workspaces under ~/Projects/<slug> instead of dumping everything in bare ~.

Session restore

Tabs reopen on launch; Grok tabs come back via grok --resume <session-id>.

Auto-update

Checks GitHub Releases at startup, with optional auto-install of the CLI tarball or DMG.

Layout & themes

Tab bar on any edge, themes, rename tabs, host-level text selection with Shift.

🖱Real mouse support

Chrome clicks always work; SGR mouse events pass through only when the child app asks for them.

🎚Echo protect

The mic is gated while GrokTerm speaks, with local barge-in so you can interrupt it.

Keys

Everything is one chord away.

Ctrl+Tnew shell Ctrl+Bnew grok tab Ctrl+Vvoice Ctrl+Gmanager rrename tab Ctrl+Qquit

Requirements

macOS 13+

Required for the app and voice. The CLI also builds and runs on Linux.

Grok Build

Optional, at ~/.grok/bin/grok — needed for Grok tabs and delegation.

Config lives in ~/.grokterm/config.json, workspace state in ~/.grokterm/workspace.json, logs in ~/.grokterm/grokterm.log.