Jia-Ethan/grok-keysmith

何を解決するか

grok-keysmith は、Grok Build のカスタムインストラクション（ホームルール）を安全に管理するためのデプロイメントツールです。ユーザーがグローバル構成に変更を加え、検証し、元に戻すことを、AGENTS.md のような重要なファイルを手動で編集せずに可能にします。

動作方法

このツールは ~/.grok ディレクトリ内の特定のファイルを管理します。新しい Grok セッションがこれらのルールを読み込むように、Markdown ファイルを ~/.grok/rules/99-keysmith.md としてデプロイします。安定性を確保するために、config.toml に互換性の隔離ブロックを挿入し、既存のフックを無効化するために ~/.grok/hooks/*.json ディレクトリを .json.disabled にリネームします。

「プレビュー優先」のアプローチを採用しており、ディスクへの変更をコミットするには明示的な --yes フラグが必要です。また、構成のずれを修正するメカニズム、フックの復元、デプロイされたルールの完全アンインストールを実行する機能も提供しています。

対象ユーザー

カスタムインストラクションを通じて AI エージェントのグローバルな振る舞いをカスタマイズしたい、Grok Build の開発者およびパワーユーザーで、バックアップと安全なロールバックメカニズムを維持したい方。

主な特徴

• 安全なデプロイ: ディスクへの書き込み前にドライランプレビューを実行。
• 非破壊的: AGENTS.md を変更せず、置き換えられたファイルのバックアップを作成。
• 構成管理: config.toml の隔離とフックの無効化により、競合を防止。
• 元に戻せる: フックの復元とデプロイの完全アンインストールを専用コマンドで実行可能。
• クロスプラットフォーム: macOS、Linux、Windows をサポート（Python 3.8+）。
• セッションスクリプティング: run --session-script 機能により、複数ターンの会話内容を1つの Grok セッションに投入可能。