Jia-Ethan/codex-keysmith

codex‑keysmith – ローカルの Codex クライアントに逆転可能な指示フックを追加する

何ができるか

• ローカルにインストールされた Codex デスクトップクライアントの設定に、プロンプトテンプレート（「keysmith」と呼ばれる）を書き込む小さな Python インストーラーを提供します。
• プロセスは プレビュー優先、承認後に適用 であり、いつでも ロールバック できます。
• Codex のバイナリを変更せず、API キーを読み取らず、インターネットにデータを送信しません。

動作方法

1. ドライラン / プレビュー – スクリプトは対象の Codex ディレクトリをスキャンし、追加されるファイルとフックコードの正確な内容を表示し、検証用に SHA‑256 チェックサムを出力します。
2. 適用 – 承認後（--yes）スクリプトはフックを適切な場所に書き込み、小さなマニフェストを更新して、新しい Codex コンバージェーションでのみ新しい動作が有効になるようにします。
3. 再活性化 / アンインストール – 後で元のファイルを復元（--restore-hooks）、フックを完全に削除（--uninstall）、または以前に保存した状態を再活性化（--reactivate）できます。

対応プラットフォーム

• macOS と Linux（公式サポート）
• Windows（ベータチャネル、x64 でテスト済み）
• Python 3.10+ を必要とします。

インストール手順

# 1. 最新リリーススクリプトをダウンロード（X.Y.Z をタグに置き換え）
base="https://github.com/Jia-Ethan/codex-keysmith/releases/download/vX.Y.Z"
curl -L "$base/codex-instruct-vX.Y.Z.py" -o codex-instruct.py
curl -L "$base/SHA256SUMS" -o SHA256SUMS
# 2. チェックサムを検証
awk '$2 == "codex-instruct-vX.Y.Z.py"' SHA256SUMS | shasum -a 256 -c -
# 3. 書き込まれる内容をプレビュー
python3 codex-instruct.py --codex-dir ~/.codex --dry-run --lang zh-CN
# 4. 準備ができたら適用
python3 codex-instruct.py --codex-dir ~/.codex --yes --lang zh-CN

~/.codex を実際の Codex インストールディレクトリに置き換えてください。

フックの削除

python3 codex-instruct.py --codex-dir ~/.codex --restore-hooks --lang zh-CN   # 元のファイルを復元
python3 codex-instruct.py --codex-dir ~/.codex --uninstall --yes --lang zh-CN # フックを完全に削除

ドキュメントとヘルプ

• 詳細な使い方: docs/reference.md
• 他の AI アシスタントにインストールを依頼する方法: docs/agent‑install.md
• セキュリティ上の考慮事項: SECURITY.md
• コミュニティディスカッション: GitHub Discussions, LINUX DO フォーラム。

ライセンス

• MIT License – 使用・変更・再配布を自由にできます。

なぜ重要なのか codex-keysmith は、安全で逆転可能な方法でローカルの Codex コーディングアシスタントの動作をパワーユーザーがカスタマイズできるようにします。新しいセッションごとに実行されるプロンプトを挿入することで、コーディング規範の強制、プロジェクト固有のコンテキストの追加、新しい指示セットの実験が、アプリケーションのコアを変更せずに可能になります。