2026-07-16 06:46:02 +01:00
|
|
|
# Grok Build User Guide
|
|
|
|
|
|
|
|
|
|
Learn how to install, configure, and extend Grok Build, the terminal-based AI coding assistant from SpaceXAI.
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## Tier 1: Essential User Docs
|
|
|
|
|
|
|
|
|
|
Start here. These guides cover what you need on your first day.
|
|
|
|
|
|
|
|
|
|
| # | Document | Description |
|
|
|
|
|
|---|----------|-------------|
|
|
|
|
|
| 1 | [Getting Started](01-getting-started.md) | Installation, first launch, authentication, basic interaction, and key concepts |
|
|
|
|
|
| 2 | [Authentication](02-authentication.md) | Browser login, API keys, OIDC/SSO, external auth providers, and device-code flow |
|
|
|
|
|
| 3 | [Keyboard Shortcuts](03-keyboard-shortcuts.md) | Reference for every key binding and mouse action in the TUI |
|
|
|
|
|
| 4 | [Slash Commands](04-slash-commands.md) | Every `/` command for sessions, models, memory, hooks, and plugins |
|
|
|
|
|
| 5 | [Configuration](05-configuration.md) | `config.toml`, `pager.toml`, environment variables, and file locations |
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## Tier 2: Core Feature Docs
|
|
|
|
|
|
|
|
|
|
Customize and extend Grok Build.
|
|
|
|
|
|
|
|
|
|
| # | Document | Description |
|
|
|
|
|
|---|----------|-------------|
|
|
|
|
|
| 6 | [Theming and Appearance](06-theming.md) | Themes, the `/theme` command, `pager.toml`, and color-support detection |
|
|
|
|
|
| 7 | [MCP Servers](07-mcp-servers.md) | External tool integrations through the Model Context Protocol |
|
|
|
|
|
| 8 | [Skills](08-skills.md) | Reusable prompt packages in the SKILL.md format |
|
|
|
|
|
| 9 | [Plugins](09-plugins.md) | Bundle and share skills, commands, agents, hooks, and MCP servers; install from marketplace sources |
|
|
|
|
|
| 10 | [Hooks](10-hooks.md) | Lifecycle scripts and HTTP callbacks for pre- and post-tool-use events |
|
|
|
|
|
| 11 | [Custom Models](11-custom-models.md) | Bring-your-own-key, Ollama, and OpenAI-compatible endpoints |
|
|
|
|
|
| 12 | [Project Rules (AGENTS.md)](12-project-rules.md) | Per-directory AGENTS.md instructions and their precedence |
|
|
|
|
|
| 13 | [Memory](13-memory.md) | Cross-session knowledge persistence with `/flush`, `/dream`, and hybrid search |
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## Tier 3: Advanced Usage Docs
|
|
|
|
|
|
|
|
|
|
Automate, script, and integrate Grok Build with other systems.
|
|
|
|
|
|
|
|
|
|
| # | Document | Description |
|
|
|
|
|
|---|----------|-------------|
|
|
|
|
|
| 14 | [Headless Mode and Scripting](14-headless-mode.md) | `grok -p`, output formats, CI/CD integration, and piping |
|
|
|
|
|
| 15 | [Agent Mode and IDE Integration](15-agent-mode.md) | ACP stdio transport, WebSocket relay, and SDK integration |
|
|
|
|
|
| 16 | [Subagents and Personas](16-subagents.md) | Parallel child sessions, agent types, personas, and capability modes |
|
|
|
|
|
| 17 | [Session Management](17-sessions.md) | Save, load, resume, rewind, compact, and the session persistence format |
|
|
|
|
|
| 18 | [Sandbox Mode](18-sandbox.md) | OS-level filesystem and network isolation profiles |
|
|
|
|
|
| 19 | [Plan Mode](19-plan-mode.md) | Structured planning, plan-file edits, and approval before coding |
|
|
|
|
|
| 20 | [Background Tasks and Monitoring](20-background-tasks.md) | `background: true`, `/loop`, `monitor`, and `Ctrl+G` to demote |
|
|
|
|
|
| 21 | [Terminal Support and Troubleshooting](21-terminal-support.md) | tmux, SSH, truecolor, clipboard, and OSC 52 |
|
|
|
|
|
| 22 | [Permissions and Safety Controls](22-permissions-and-safety.md) | `dontAsk` mode, auto-approved tools, the safe-bash list, and restrictive PreToolUse hooks (such as git/gh-only) |
|
2026-07-18 19:48:28 +01:00
|
|
|
| 23 | [Agent Dashboard](23-dashboard.md) | Central overview of local sessions and forks |
|
|
|
|
|
| 24 | [Monitoring Usage (External OpenTelemetry)](24-monitoring-usage.md) | Customer OTEL export |
|
