git404hub

what is grok-cli fr?

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.

vibe map

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

what do people make with this?

VIBE 1

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

VIBE 2

Run the agent headlessly in a script or CI pipeline.

VIBE 3

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

VIBE 4

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

what's the stack?

RustCargoHomebrewnpm

how it stacks up fr

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 i run it?

Difficulty · moderate time til it works · 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.

in plain english

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.

prompts (copy fr)

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

what is grok-cli fr?

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.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.