> ## Documentation Index
> Fetch the complete documentation index at: https://docs.memorycrystal.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Grok Build

> Connect Memory Crystal to Grok Build at Capture tier — tools, automatic capture, skills, and Managed Block. No automatic recall.

Grok Build is **Capture tier**. Memory Crystal registers the tool surface, captures turns automatically, installs skills, and writes a Managed Block to `~/.grok/AGENTS.md`. Recall is deliberate, not automatic: the harness ignores hook stdout on passive events, so it cannot inject context. Call `crystal_recall` or `crystal_what_do_i_know` when you need past context.

Do not expect memories to appear in the prompt on their own. Do not use Claude-compat (`[compat.claude]`) as a substitute for this install.

## Recommended: universal installer

```bash theme={"system"}
curl -fsSL https://memorycrystal.ai/crystal | bash -s -- --targets grok
```

```powershell theme={"system"}
iwr https://memorycrystal.ai/install.ps1 -OutFile install.ps1
.\install.ps1 -Targets grok
```

<Note>PowerShell configures MCP and skills. Shared capture hooks and the Managed Block are installed by the Bash installer (`hooks.shells` is bash-only).</Note>

### Agent Instructions

```text theme={"system"}
Install Memory Crystal for Grok Build. Grok is Capture tier: automatic capture and tools, no automatic recall (the harness cannot inject context). Run the official installer, follow auth/backend prompts, and do not hand-edit ~/.grok config unless the installer fails. After install, run grok inspect and confirm memory-crystal MCP, hooks, skills, and ~/.grok/AGENTS.md. Use crystal_recall / crystal_what_do_i_know before answering from past work.

macOS/Linux/WSL:
curl -fsSL https://memorycrystal.ai/crystal | bash -s -- --targets grok

Windows PowerShell:
iwr https://memorycrystal.ai/install.ps1 -OutFile install.ps1; .\install.ps1 -Targets grok
```

For local data storage, add `--backend local` in Bash or `-Backend local` in PowerShell. See [Local-First Setup](/configuration/local-first).

## What the Bash installer writes

* MCP via `grok mcp add` when the CLI is present, otherwise `[mcp_servers.memory-crystal]` with `url` and `headers` in `~/.grok/config.toml`
* Capture hooks at `~/.grok/hooks/memory-crystal.json` (SessionStart, UserPromptSubmit, Stop — **no matcher** on lifecycle events)
* Skills under `~/.grok/skills/`
* Managed Block in `~/.grok/AGENTS.md` only (no other instruction files)

`GROK_HOME` overrides the default directory for MCP, hooks, and skills. The managed instructions remain at `~/.grok/AGENTS.md`.

## Verify

Restart Grok or run `grok inspect`. After Bash installation, confirm the MCP server, hooks, skills, and managed instructions. After native PowerShell installation, verify MCP and skills; that installer does not write the hooks or managed instructions.

## Uninstall

```bash theme={"system"}
curl -fsSL https://memorycrystal.ai/uninstall.sh | bash -s -- --targets grok
```

Removes the hook file, the MCP entry, the Managed Block, and Crystal skills. See [Uninstall](/help/uninstall).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.