Key highlights:
• Telegram remote control — pair once, then drive the agent from your phone while the CLI keeps running on your machine
• Sub-agents on by default — foreground `task` delegation plus background `delegate` for read-only deep dives
• Built-in computer use — a `computer` sub-agent (via [agent-desktop](https://github.com/lahfir/agent-desktop)) that snapshots and drives your macOS desktop
• Shuru microVM sandbox — run shell commands inside an isolated VM so the agent can't touch your host filesystem or network (macOS 14+ Apple Silicon)
• Live X + web search — `search_x` and `search_web` tools, so the agent isn't stuck in a 2023 knowledge cutoff
What Is grok-cli?
grok-cli is an open-source terminal coding agent that connects to xAI's Grok API. Conceptually it sits in the same category as Claude Code, Codex CLI, OpenCode, and Gemini CLI: a full-screen terminal UI that understands your codebase, edits files, runs shell commands, searches the web, and manages long-running tasks — but pointed at Grok models like grok-4.3 and the grok-4.20 multi-agent variants.
The important framing, because it confuses a lot of people: there are two things called "Grok" in the coding-agent world right now.
1. Grok Build — xAI's official agent harness, open-sourced under Apache 2.0 in mid-July 2026. It's ~840K lines of Rust, is the code behind the real grok command, and takes no external PRs. It's the safe, production choice.
Installation
The fast path is a single curl command that bundles Bun for you:
curl -fsSL https://raw.githubusercontent.com/superagent-ai/grok-cli/main/install.sh | bash
If you already have [Bun](https://bun.sh/) on your PATH, you can skip the bundled runtime:
Headless Mode: The Part That Actually Matters for Automation
Interactive TUIs are nice, but the reason to care about a CLI agent is scripting. grok-cli's headless mode is solid:
grok --prompt "run the test suite and summarize failures"
grok -p "refactor the auth module" --directory /path/to/project --max-tool-rounds 30
Read the Full Deep Dive
This is a condensed version. The full article includes architecture diagrams, code examples, comparison tables, and practical use cases.
👉 Read the complete analysis on andrew.ooo
Topics: grok, grok-cli, coding-agent, cli, xai

Comments
Nothing yet. Say the first thing.
Sign in to join the conversation.