Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Install

grove ships as two static binaries (Linux, macOS, Windows; x86_64 + aarch64 where applicable). No grammar is compiled in — they load at runtime from the hosted registry.

BinaryWhat it is
groveThe CLI (grove <verb>) and the 7-tool structural MCP server (grove serve). This is what most projects want.
grove-exploreThe optional LLM-backed code locator — its own MCP server (grove-explore serve), plus the config and tap TUIs.

Every install channel below places both on your PATH from v0.4.1 onward. grove-explore is inert until configured, so installing it costs you nothing if you never opt in; see Setup for grove init --as mcp-llm.

curl | sh (Linux / macOS)

Detects your platform, verifies the sha256, installs to ~/.local/bin:

curl -fsSL https://raw.githubusercontent.com/Entelligentsia/grove/main/install.sh | sh

Honors HTTP_PROXY/HTTPS_PROXY/ALL_PROXY + NO_PROXY via curl/wget.

PowerShell (Windows)

Verifies the sha256, installs to $env:LOCALAPPDATA\grove\bin:

irm https://raw.githubusercontent.com/Entelligentsia/grove/main/install.ps1 | iex

Honors HTTPS_PROXY/HTTP_PROXY/ALL_PROXY + NO_PROXY from the environment (set them before running the one-liner). For an explicit -Proxy, download the script first — piping into iex doesn’t accept parameters:

iwr https://raw.githubusercontent.com/Entelligentsia/grove/main/install.ps1 -OutFile install.ps1
./install.ps1 -Proxy "http://proxy.corp:8080"

-InstallDir and -Version (or $env:GROVE_INSTALL_DIR / $env:GROVE_VERSION) override the defaults, mirroring install.sh’s env vars. Only the x86_64-pc-windows-msvc prebuilt is published today; other Windows archs fall back to cargo install.

Homebrew (macOS / Linux)

brew install Entelligentsia/grove/grove

Tap: Entelligentsia/homebrew-grove.

npm

Provides both the grove and grove-explore commands via a downloaded, checksum-verified prebuilt:

npm install -g @entelligentsia/grove

The postinstall download honors HTTP_PROXY/HTTPS_PROXY/ALL_PROXY + NO_PROXY from the environment.

From source

The two binaries are separate crates, so installing from source is the one channel where you choose. grove alone:

cargo install grove-cst-cli        # installs `grove`

Add the locator if you want it:

cargo install grove-explore-bin    # installs `grove-explore`

Or straight from git — the repo is a workspace, so name the package:

cargo install --git https://github.com/Entelligentsia/grove grove-cst-cli

Build from a checkout — --workspace builds both:

cargo build --release --workspace   # first build compiles wasmtime (~30s), then incremental
# binaries at target/release/grove and target/release/grove-explore

As an agent skill (cross-harness)

The skill works across 70+ harnesses (Claude Code, Cursor, Codex, Cline, …) via the agent-skills tool:

npx skills add Entelligentsia/grove

The skill steers your agent to grove’s MCP tools when present, else the grove CLI — and self-installs the binary on first use if it’s missing (npm i -g @entelligentsia/grove, then grove init --as skill to fetch grammars). So this one command is enough to get grove working in a fresh repo. See Setup for grove init --as mcp|skill|both.

Prebuilt binaries

Attached to each GitHub Release. Each platform archive contains both grove and grove-explore alongside a .sha256 sidecar. Archives predating v0.4.1 hold grove only; the installers tolerate those and simply skip the second binary.


Next: Setup · Languages & grammars