Files
Kigi-CLI/crates/codegen/kigi-tui/docs/user-guide
ZacharyZhang-NY 5e4e24db99 M2 audit: excise managed connectors and xAI media-gen tools
Managed connectors (grok.com MCP admin) removed root-and-branch:
- The managed-MCP fetch/injection pipeline is gone, including the whole
  kigi-shell-session-support crate (managed-config fetch client, gateway
  tool catalog + dispatch, header injection, refresh task), reactive
  managed re-auth, mcp_doctor's grok.com-source discovery, and the
  [managed_mcps] config surface.
- TUI: the 'Managed by grok.com' section, connectors URL/deep-link,
  Action::OpenManagedConnectors, and session_team_id are gone. Local MCP
  management (list/toggle/add/remove/auth/tools) is fully intact.
- Kept as LOCAL policy: managed-settings.json MCP allow/deny enforcement,
  the multi-source local MCP merge, folder-trust gating. PluginOrigin
  Project/User labels kept (they tag locally discovered plugin dirs).

imagine/media-gen tools (xAI image/video generation) removed:
- image_gen, image_edit, video_gen, image_to_video, reference_to_video
  implementations, registrations, ToolKind/ToolInput/Output variants
  (serde-safe), config plumbing end to end, ZDR video machinery,
  /imagine + /imagine-video commands and guidance text, the bundled
  imagine skill (added to legacy cleanup so user installs delete it),
  and the media-gen render path.
- Kept: image INPUT (paste/attach, [Image #N] meta, pdf/image fetch,
  clipboard wrap), generic media-ref rendering, and the generic tool
  401-retry machinery (tests renamed, assertions unweakened).
- deploy_app stays: it is a permanently-disabled local stub deploying
  nowhere.

121 files changed, 8 deleted. Gates: workspace check/clippy 0/0, fmt,
deny ok; suites green (tools 2554, shell 4862, tui 6608, workspace
1042). Remaining grok.com strings live only in the auth-method ids and
changelog archives (§9/M3 sweep).
2026-07-17 23:45:05 -04: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 Installation, first launch, authentication, basic interaction, and key concepts
2 Authentication Browser login, API keys, OIDC/SSO, external auth providers, and device-code flow
3 Keyboard Shortcuts Reference for every key binding and mouse action in the TUI
4 Slash Commands Every / command for sessions, models, memory, hooks, and plugins
5 Configuration 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 Themes, the /theme command, pager.toml, and color-support detection
7 MCP Servers External tool integrations through the Model Context Protocol
8 Skills Reusable prompt packages in the SKILL.md format
9 Plugins Bundle and share skills, commands, agents, hooks, and MCP servers
10 Hooks Lifecycle scripts and HTTP callbacks for pre- and post-tool-use events
11 Custom Models Bring-your-own-key, Ollama, and OpenAI-compatible endpoints
12 Project Rules (AGENTS.md) Per-directory AGENTS.md instructions and their precedence
13 Memory 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 grok -p, output formats, CI/CD integration, and piping
15 Agent Mode and IDE Integration ACP stdio transport, WebSocket relay, and SDK integration
16 Subagents and Personas Parallel child sessions, agent types, personas, and capability modes
17 Session Management Save, load, resume, rewind, compact, and the session persistence format
18 Sandbox Mode OS-level filesystem and network isolation profiles
19 Plan Mode Structured planning, plan-file edits, and approval before coding
20 Background Tasks and Monitoring background: true, /loop, monitor, and Ctrl+G to demote
21 Terminal Support and Troubleshooting tmux, SSH, truecolor, clipboard, and OSC 52
22 Permissions and Safety Controls dontAsk mode, auto-approved tools, the safe-bash list, and restrictive PreToolUse hooks (such as git/gh-only)