docs: add Grok Build agent page (#287)

* docs: add Grok agent page

Add agents/grok.mdx documenting the pre-built `grok` sandbox template,
mirroring amp.mdx's structure (CLI, headless with -p/--always-approve,
cloned-repo example, streaming JSON, custom template). Register it in
docs.json navigation and add the grok.svg icon.

* docs: fix grok icon fill so it renders in the sidebar

The icon used fill=currentColor which renders blank in the Mintlify icon
slot. Use an explicit neutral fill like the codex icon so it shows in both
light and dark themes, matching how amp hardcodes its brand color.

* docs: rename Grok page to Grok Build

Use the product name Grok Build and the grok-build template id (e2b sbx
create grok-build). The binary invoked inside the sandbox stays grok.

* docs: rename template id back to grok

Per review, the template id is grok (e2b sbx create grok). Keeps the Grok
Build product name in the title and prose; the binary stays grok.

Author: OndrejDrapalik

docs.json

@@ -63,6 +63,7 @@
               "docs/agents/codex",
               "docs/agents/crabbox",
               "docs/agents/devin",
+              "docs/agents/grok",
               "docs/agents/openai-agents-sdk",
               {
                 "group": "OpenClaw",

docs/agents/grok.mdx

@@ -0,0 +1,185 @@
+---
+title: "Grok Build"
+description: "Run Grok Build in a secure E2B sandbox with full filesystem, terminal, and git access."
+icon: "/images/icons/grok.svg"
+---
+
+[Grok Build](https://x.ai/cli) is xAI's coding agent and CLI. E2B provides a pre-built `grok` template with Grok Build already installed.
+
+## CLI
+
+Create a sandbox with the [E2B CLI](/docs/cli).
+
+```bash
+e2b sbx create grok
+```
+
+Once inside the sandbox, start Grok Build.
+
+```bash
+grok
+```
+
+## Run headless
+
+Use `-p` for non-interactive mode and `--always-approve` to auto-approve all tool calls (safe inside E2B sandboxes). Grok Build authenticates with an API key from the [xAI console](https://console.x.ai) via the `XAI_API_KEY` environment variable.
+
+<CodeGroup>
+```typescript JavaScript & TypeScript
+import { Sandbox } from 'e2b'
+
+const sandbox = await Sandbox.create('grok', {
+  envs: { XAI_API_KEY: process.env.XAI_API_KEY },
+})
+
+const result = await sandbox.commands.run(
+  `grok --always-approve -p "Create a hello world HTTP server in Go"`
+)
+
+console.log(result.stdout)
+await sandbox.kill()
+```
+```python Python
+import os
+from e2b import Sandbox
+
+sandbox = Sandbox.create("grok", envs={
+    "XAI_API_KEY": os.environ["XAI_API_KEY"],
+})
+
+result = sandbox.commands.run(
+    'grok --always-approve -p "Create a hello world HTTP server in Go"',
+)
+
+print(result.stdout)
+sandbox.kill()
+```
+</CodeGroup>
+
+### Example: work on a cloned repository
+
+<CodeGroup>
+```typescript JavaScript & TypeScript
+import { Sandbox } from 'e2b'
+
+const sandbox = await Sandbox.create('grok', {
+  envs: { XAI_API_KEY: process.env.XAI_API_KEY },
+  timeoutMs: 600_000,
+})
+
+await sandbox.git.clone('https://github.com/your-org/your-repo.git', {
+  path: '/home/user/repo',
+  username: 'x-access-token',
+  password: process.env.GITHUB_TOKEN,
+  depth: 1,
+})
+
+const result = await sandbox.commands.run(
+  `cd /home/user/repo && grok --always-approve -p "Add error handling to all API endpoints"`,
+  { onStdout: (data) => process.stdout.write(data) }
+)
+
+const diff = await sandbox.commands.run('cd /home/user/repo && git diff')
+console.log(diff.stdout)
+
+await sandbox.kill()
+```
+```python Python
+import os
+from e2b import Sandbox
+
+sandbox = Sandbox.create("grok", envs={
+    "XAI_API_KEY": os.environ["XAI_API_KEY"],
+}, timeout=600)
+
+sandbox.git.clone("https://github.com/your-org/your-repo.git",
+    path="/home/user/repo",
+    username="x-access-token",
+    password=os.environ["GITHUB_TOKEN"],
+    depth=1,
+)
+
+result = sandbox.commands.run(
+    'cd /home/user/repo && grok --always-approve -p "Add error handling to all API endpoints"',
+    on_stdout=lambda data: print(data, end=""),
+)
+
+diff = sandbox.commands.run("cd /home/user/repo && git diff")
+print(diff.stdout)
+
+sandbox.kill()
+```
+</CodeGroup>
+
+## Build a custom template
+
+If you need to customize the environment (e.g. pre-install dependencies, add config files), build your own template on top of the pre-built `grok` template.
+
+<CodeGroup>
+```typescript JavaScript & TypeScript
+// template.ts
+import { Template } from 'e2b'
+
+export const template = Template()
+  .fromTemplate('grok')
+```
+```python Python
+# template.py
+from e2b import Template
+
+template = (
+    Template()
+    .from_template("grok")
+)
+```
+</CodeGroup>
+
+<CodeGroup>
+```typescript JavaScript & TypeScript
+// build.ts
+import { Template, defaultBuildLogger } from 'e2b'
+import { template as grokTemplate } from './template'
+
+await Template.build(grokTemplate, 'my-grok', {
+  cpuCount: 2,
+  memoryMB: 2048,
+  onBuildLogs: defaultBuildLogger(),
+})
+```
+```python Python
+# build.py
+from e2b import Template, default_build_logger
+from template import template as grok_template
+
+Template.build(grok_template, "my-grok",
+    cpu_count=2,
+    memory_mb=2048,
+    on_build_logs=default_build_logger(),
+)
+```
+</CodeGroup>
+
+Run the build script to create the template.
+
+<CodeGroup>
+```bash JavaScript & TypeScript
+npx tsx build.ts
+```
+```bash Python
+python build.py
+```
+</CodeGroup>
+
+## Related guides
+
+<CardGroup cols={3}>
+  <Card title="Sandbox persistence" icon="clock" href="/docs/sandbox/persistence">
+    Auto-pause, resume, and manage sandbox lifecycle
+  </Card>
+  <Card title="Git integration" icon="code-branch" href="/docs/sandbox/git-integration">
+    Clone repos, manage branches, and push changes
+  </Card>
+  <Card title="SSH access" icon="terminal" href="/docs/sandbox/ssh-access">
+    Connect to the sandbox via SSH for interactive sessions
+  </Card>
+</CardGroup>