gitwtfhub

wtf is grok-cli?

happyfeetw/grok-cli — explained in plain English

Analysis updated 2026-05-18

2RustAudience · developerComplexity · 3/5LicenseSetup · moderate

TL;DR

A macOS focused community fork of Grok Build, SpaceXAI's terminal AI coding agent, packaged as a separate grok-cli command.

Mindmap

mindmap
  root((grok-cli fork))
    What it does
      Terminal AI coding agent
      Edits files and runs commands
      Headless and editor modes
    Tech stack
      Rust
      Cargo
      DotSlash
      protoc
    Use cases
      Coding assistant in terminal
      CI scripting agent
      Editor integration via ACP
    Audience
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Install a terminal based AI coding agent on macOS without conflicting with the official grok command.

REASON 2

Run the agent headlessly in a script or CI pipeline.

REASON 3

Embed the coding agent inside an editor using the Agent Client Protocol.

REASON 4

Use system level proxy settings that the official build does not read the same way.

What's in the stack?

RustCargoHomebrewnpm

How it stacks up

happyfeetw/grok-cli132ikl/game1lystore/pay-dcp
Stars222
LanguageRustRustRust
Last pushed2020-12-30
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity3/52/53/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Prebuilt binaries only cover macOS, other platforms require building from source with Rust.

Apache 2.0, which allows free use, modification, and distribution including commercially, as long as you keep the license notice.

Wtf does this do

grok-cli is a community fork of Grok Build, SpaceXAI's terminal based AI coding agent. The original tool runs as a fullscreen text interface that reads your codebase, edits files, runs shell commands, searches the web, and manages long running tasks, either interactively in the terminal, headlessly for scripts and CI pipelines, or embedded inside code editors through the Agent Client Protocol. This particular repository is not the official version. It is maintained separately under the name happyfeetw, with system proxy support re-enabled and packaging focused on macOS. The command it installs is called grok-cli rather than grok, so it does not conflict with the official SpaceXAI tool if both are installed on the same machine. In app updates pull from this fork's own npm package and GitHub releases, not from the official x.ai channels. The fork can be installed through npm or bun, through Homebrew using a custom tap, or by downloading a prebuilt tarball from GitHub releases. All of these prebuilt options currently only cover macOS, on both Apple Silicon and Intel chips. Building from source is also supported and requires the Rust toolchain, a tool called DotSlash for fetching some hermetic build dependencies, and protoc for compiling protocol buffer code. Source builds work on macOS and Linux, while Windows support is described as best effort and not actively tested. On its first launch, the tool opens a browser window so the user can authenticate. After that it behaves as a coding assistant that lives in the terminal. The underlying project is organized into many small Rust crates covering the text interface, the agent runtime, individual tools like file editing and search, and workspace handling for git and execution. This fork is aimed at developers on macOS who want to use Grok Build's coding agent through a package distribution that isn't tied to the official installer, particularly if they rely on system level proxy settings that the official build does not read the same way.

Yoink these prompts

Prompt 1
Help me install grok-cli on macOS using Homebrew.
Prompt 2
Walk me through building grok-cli from source with Rust and DotSlash.
Prompt 3
Explain how grok-cli's proxy support differs from the official Grok Build tool.
Prompt 4
Show me how to run grok-cli headlessly in a CI pipeline.
Prompt 5
Help me set up the Agent Client Protocol integration for grok-cli in my editor.

Frequently asked questions

wtf is grok-cli?

A macOS focused community fork of Grok Build, SpaceXAI's terminal AI coding agent, packaged as a separate grok-cli command.

What language is grok-cli written in?

Mainly Rust. The stack also includes Rust, Cargo, Homebrew.

What license does grok-cli use?

Apache 2.0, which allows free use, modification, and distribution including commercially, as long as you keep the license notice.

How hard is grok-cli to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is grok-cli for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.