Codex CLI と Hooks / Plugins とは(短く)
Codex CLI は OpenAI が出しているターミナル用 AI 開発エージェント で、codex コマンドでローカルのリポジトリと対話しながらコードを書いたり、ファイルを編集したりする CLI ツール。
TUI(Terminal User Interface — ターミナルの中で動く GUI 風のインターフェース)を持っていて、入力欄やセッション履歴、ステータス表示などがターミナル画面に表示される。
ここで出てくる Hooks は、Codex のライフサイクルイベント(例: コマンド実行前、ファイル書き込み前、セッション開始時など)に合わせて自動実行されるスクリプトの仕組み。チームのルール(「コミット前には必ず lint」「秘密情報を含むファイルは書き込みブロック」など)や安全確認を自動化するのに使われる。
Plugins は Codex 本体の機能を拡張する仕組みで、社内で作った便利コマンドを他メンバーに配る用途などに使う。
これまで両者は「設定ファイルを開かないと どんな Hook がどのタイミングに刺さっているか / どの Plugin が入っているか が見えにくい」という課題があった。0.129.0 はそこに正面から手を入れた版です。
何が変わった
1. `/hooks` コマンドで Hooks を TUI から確認できる
今回いちばんのポイント。/hooks を実行すると、ライフサイクルイベントごとに、どの Hook が登録されていて、有効か無効かを TUI 上で一覧できるようになった。
これまでは、Hooks の全体像を把握するには 設定ファイル (~/.codex/config.toml 系の設定や、各プロジェクトのローカル設定ファイル)を実際に開いて読む必要があった。チームで Hooks を増やしていくと、誰がいつ何を仕込んだのか、本当に有効になっているのかが、配布されてきた人からは見えづらい問題があった。
/hooks は 「今のこの Codex セッションで、何が自動実行される設定になっているのか」を画面で見せることで、ブラックボックス感を解消する役割を担う。Hooks をルールや安全確認の自動化に使っているチームには、運用しやすさが目に見えて変わるアップデート。
2. `/vim` で入力欄を Vim 風に編集できる
/vim を打つと、Codex の入力欄を Vim 風キーバインドで操作 できるようになる。長い指示を書いている途中で前の行に戻って直したり、単語単位で消したりといった、Vim に慣れた操作でプロンプトを編集できる。
毎回コマンドで切り替えるのが面倒な人向けに、設定で最初から Vim モードを有効にしておくこともできる。長文プロンプトを書き直しながら作業するタイプには地味に効く改善。
3. resume 画面が使いやすくなった
過去の会話セッションを再開する resume 画面で、目的のセッションを探しやすくなった。「途中で止めた作業に戻ることが多い人」、たとえば長いタスクをセッションをまたいで進めるタイプの使い方をしている人には便利な変更。
4. status line が強化(PR 番号 / Git ブランチ / ブランチ差分)
ターミナル下部の status line に、PR 番号・Git ブランチ・ブランチ差分などが表示できるようになった。「今どのブランチで作業しているのか」「対応する PR は何番か」「main からどのくらい差分があるのか」が画面の固定位置で見えるので、複数ブランチや複数 PR を並列で扱う人に効く。
5. `/keymap debug` でキー認識を確認できる
/keymap debug は、押したキーが Codex 側でどのように認識されているか / どの keymap に紐付いているかを確認するためのコマンド。ターミナルや tmux 越しでショートカットが効かない ときに、「そもそもキー入力が Codex に届いていないのか」「届いているが別の keymap になっているのか」を切り分ける用途で使える。
6. Plugins がチーム利用に進化
Plugins まわりに、チームで使うための機能が入った。具体的には:...
誰にどう効くか
・Codex をチーム運用しているチーム: /hooks で 「今の Codex で何が自動実行されるのか」を全員が画面から確認できる。 Hooks がブラックボックス化していた状態を脱せる。Plugins もチーム単位で運用しやすくなる。
・Hooks を運用ルールや安全確認に使っている人: 設定ファイルを開かずに 登録 Hook の一覧と有効/無効の状態を確認できる。「無効になっていると思っていた Hook がまだ有効だった」「意図しない順序で発火していた」系のトラブルシュートが速くなる。
・長文プロンプトをよく書く人 / Vim 派: /vim で 入力欄を Vim 風に編集できる。設定でデフォルト Vim にもできる。
・複数ブランチ・複数 PR を並列で扱う人: status line に PR 番号 / Git ブランチ / ブランチ差分が出るので、今どこで作業しているのかを画面の固定位置で確認できる。
・過去セッションの再開を頻繁にする人: resume 画面で目的のセッションを探しやすい。
・ターミナル / tmux でショートカットが効かないと困っている人: /keymap debug で 押したキーが Codex 側でどう認識されているか を確認できる。原因切り分けに使える。
・社内 Plugins を配布したい人: ワークスペース共有・共有範囲制御・marketplace 更新削除がそろい、個人拡張からチーム配布へ踏み出せる。
触ってみるには / 注意点
・触り方: Codex CLI を 0.129.0 に更新する。アップデート後、ターミナルで Codex を起動して /hooks を打てば、登録されている Hooks のライフサイクルイベント別ビューが TUI に出る。入力欄を Vim ライクにしたいときは /vim。キー認識の確認は /keymap debug。
・注意点 1: 「新機能」ではなく「運用性の改善」が中心の版。モデル能力が上がったり、新しい言語・新しいフレームワークに対応したりというアップデートではない。Codex を 1 人で軽く触っているだけの段階だと、/vim 以外の恩恵は実感しにくいかもしれません。
・注意点 2: /hooks で見えるのはあくまで「現在の設定で何が登録されているか」。Hook の 中身(実際に何をするスクリプトか) までを TUI 上で読めるかは設定ファイル側に依存するので、最終的には設定ファイルを当たる必要が残ります。
・注意点 3: Plugins のチーム共有機能を使うには、marketplace 側の準備や、ワークスペースの共有設定を別途する必要がある。個人利用のままでは効果は出ない。
関連リンク
・元の解説投稿: <https://x.com/akihiro_genai/status/2052534728293781852>
_Status: pending — 人間レビュー待ち。_
