grok

# Grok Build CLI — Hermes Orchestration Guide Delegate coding tasks to [Grok Build](https://docs.x.ai/build/overview) (xAI's autonomous coding agent CLI, the `grok` command) via the Hermes terminal. Grok can read files, write code, run shell commands, spawn subagents, and manage git workflows. It runs three ways: an interactive TUI, **headless** (`-p`), and as an **ACP agent** over JSON-RPC. This is the third sibling to `codex` and `claude-code`. The orchestration pattern is nearly identical — **prefer headless `-p` for one-shots**, use a PTY for interactive sessions. ## When to use - Building features - Refactoring - PR reviews - Batch issue fixing - Any task where you'd otherwise reach for Codex / Claude Code but want Grok ## Prerequisites - **Install (preferred):** `npm install -g @xai-official/grok` - The official installer `curl -fsSL https://x.ai/cli/install.sh | bash` also works, but the `x.ai` host is Cloudflare-walled in some environments. The npm path avoids that dependency entirely. - **Auth — SuperGrok / X Premium+ subscription (primary path):** - Run `grok login` once → opens a browser for OAuth → token cached in `~/.grok/auth.json`. This uses your **SuperGrok or X Premium+** subscription (no per-token API billing). - Check sign-in state by looking for `~/.grok/auth.json`, or run a cheap headless smoke test: `grok --no-auto-update -p "Say ok."` - In the TUI, `/logout` signs out and `/login` (or relaunching) signs back in. - **No ...