grokpack 是面向 Claude Code 的 Grok Build 配套套件，定位为“观察、驱动、显示”三合一。它本身是一个轻量伞形项目，负责安装、更新与文档化 Grok Build 专用工具；每个组件都拥有独立仓库，本套件只作为统一入口。它不捆绑多引擎 fuse/route 工具（如 fleet-fuse、peer 等），多引擎编排属于另一套跨模型层。
用途方面，grokpack 提供三个组件：grokprint 用于观察（orientation card）、grokdrive 用于驱动（由 Grok 执行、Claude 编排并设门控）、grok-hud 用于在 tmux 中显示 HUD。套件不自行实现这些功能，而是作为统一安装与管理入口，把各自独立仓库的工具集合起来。
主要能力：安装后套件 CLI 会出现在 PATH 中，路径为 ~/.local/bin/grokpack。组件解析顺序为：优先读取环境变量 GROKPACK__DIR，其次查找本目录父级下的同级目录（例如 ~/repos/grokprint），最后从 Rennlabs/ 进行 git clone。安装或更新后，grokpack.lock 会固定组件版本@sha。grokdrive 的门控仅在安装后启动的 Claude Code 会话中生效，因此需开启新会话后再运行 grokdrive on。grokprint 的 hooks 可在 Grok 中通过 Ctrl+L → Hooks → r 重新加载。若 ~/.local/bin/grok-hud 是普通文件（旧副本），可使用 ./install.sh --force 处理。
使用方式：.claude-plugin/marketplace.json 列出了插件形态的组件（grokprint、grokdrive），但该文件为草稿，依赖前需对照当前 Claude Code marketplace schema 进行校验。独立的插件形态安装仍可通过各组件自带的 ./install.sh，或将仓库放入自己控制的 marketplace 来完成。每次公开发布时，应在 registry 中运行 Update playbook。关于各工具的使用时机，完整说明见 docs/routing.md。
适用场景：需要在 Claude Code 中配合 Grok Build 进行观察、驱动与显示的用户，可通过 grokpack 统一管理 grokprint、grokdrive、grok-hud 等组件。多引擎编排（fleet-fuse / FrontierFuse / peer）属于独立的跨模型层，不在本套件范围内。
限制说明：本项目为非官方套件，与 xAI 无关联，属于尽力而为的配套方案，标志与组件 API 可能随时变更，恕不另行通知。发布相关：MIT © 2026 Renn Labs。
