Jia-Ethan/grok-keysmith

解决的问题

grok-keysmith 是一个专为 Grok Build 设计的部署工具，用于安全地管理自定义指令（主页规则）。它允许用户在不手动编辑 AGENTS.md 等关键文件的情况下，安全地部署、验证并撤销全局配置的更改。

工作原理

该工具通过管理 ~/.grok 目录内的特定文件来工作。它将一个 Markdown 文件部署为 ~/.grok/rules/99-keysmith.md，以便新 Grok 会话加载这些规则。为确保稳定性，它会在 config.toml 中注入兼容性隔离块，并通过将 ~/.grok/hooks/*.json 目录重命名为 .json.disabled 来禁用现有钩子。

它采用“先预览”的方法，需要显式的 --yes 标志才能将任何更改提交到磁盘。它还提供机制来协调配置漂移、恢复钩子，并完全卸载已部署的规则。

适用人群

希望使用自定义指令来定制 AI 代理全局行为，同时保持备份和安全回滚机制的 Grok Build 开发者和高级用户。

主要亮点

• 安全部署：在写入磁盘前进行预览运行（dry-run）。
• 非破坏性：不修改 AGENTS.md，并为被替换的文件创建备份。
• 配置管理：处理 config.toml 的隔离和钩子禁用，防止冲突。
• 可逆操作：提供专用命令以恢复钩子并完全卸载部署。
• 跨平台支持：支持 macOS、Linux 和 Windows（Python 3.8+）。
• 会话脚本：包含 run --session-script 功能，可将多轮对话输入到单个 Grok 会话中。