Installation

Single platform binary. Runtime dependency: Pi ≥ 0.99.0. Current release line: 0.0.8.

macOS / Linux

Detects platform, installs to ~/.local/bin, and creates a pi-grok alias symlink.

One-line install

curl -fsSL https://github.com/Dwsy/grok-pi/releases/latest/download/install.sh | sh

Override install dir with GROK_PI_INSTALL_DIR.

PowerShell install

irm https://github.com/Dwsy/grok-pi/releases/latest/download/install.ps1 | iex

Install Pi

npm install --global @earendil-works/pi-coding-agent

Node.js ≥ 22.19.0 recommended for Pi package installs. grok-pi spawns pi (override with --pi-bin / PI_BIN).

New session

cd your-project && grok-pi

Continue last session

grok-pi --continue

Resume by partial UUID

grok-pi --session 019f88c

Coming from stock Grok or interactive Pi? See Migration.

Check version

grok-pi --version

Expect grok-pi 0.0.8 or newer.

Check

grok-pi update --check

Install latest

grok-pi update

Background checks try GitHub Releases, then the official scoped npm metadata, then the JSP proxy. Disable with GROK_PI_NO_AUTO_UPDATE=1.

grok-pi self-heals: binary-search the extension list, print the culprit, relaunch without it. Manual escape:

No extensions

grok-pi -ne

Rust 1.92.0 (see rust-toolchain.toml), Node.js 22.19.0+, npm, system Pi.

Build

./build.sh

Run locally

PI_BIN=pi ./run-local.sh /path/to/project