Pi用Codex検索ツール「pi-codex-search」

Tool
Pi用Codex検索ツール「pi-codex-search」

Pi用Codex検索ツール「pi-codex-search」

Pi（パイ）拡張として、OpenAI Codexのウェブ検索／リサーチ機能をネイティブなPiツールとして提供する軽量パッケージ。/codex-searchコマンドで質問を投げると、Codexをロックされた検索プロファイルで実行し、検索進捗（経過時間・検索・ページカウント）をリアルタイムに更新しながら結果を返します。開発はTypeScriptで行われ、デモGIFや設定済みの実行フラグがREADMEに記載されています。（約300字）

https://github.com/mikeyobrien/pi-codex-search

概要

pi-codex-searchは、Piプラットフォーム向けの拡張パッケージで、OpenAI Codexの「ウェブ調査（web research）」機能をPiのネイティブツールとしてラップして提供します。ユーザーはチャット内から /codex-search を実行するだけで、Codexを「検索」プロファイルで安全に起動し、検索進行状況（経過時間、検索数、ページ数）をライブで受け取りながら結果を取得できます。実行は読み取り専用サンドボックス、エフェメラル実行、JSON出力などの安全指向フラグで行われます。デモGIFが同梱され、使い方が視覚的に示されています。（約300字）

GitHub

リポジトリの統計情報

  • スター数: 2
  • フォーク数: 0
  • ウォッチャー数: 2
  • コミット数: 11
  • ファイル数: 9
  • メインの言語: TypeScript

主な特徴

  • /codex-search コマンドでCodexによるウェブ検索をPi内から利用可能
  • 実行中に経過時間・検索数・ページ数などのライブ進捗を表示
  • 安全重視の実行オプション（—ephemeral、—sandbox read-only、—skip-git-repo-check）
  • JSONLなど機械処理しやすいフォーマットでの出力をサポート

技術的なポイント

pi-codex-searchはTypeScriptで実装され、Piの拡張メカニズムに接続してCodexをサブプロセスとして起動する設計です。Codexにはあらかじめ「検索（—search exec）」プロファイルを与え、出力をJSON（JSONL形式を想定）にすることで、Pi側で逐次解析・表示を行います。実行時フラグとして —ephemeral（状態を残さない）、—skip-git-repo-check（リポジトリチェックの回避）、—sandbox read-only（読み取り専用サンドボックス）を指定しており、外部アクセスや書き込みのリスクを抑えた安全な実行環境を確保しています。進捗表示はCodexの出力ストリームをパースして経過時間やページ／検索カウンタを抽出し、PiのチャットUIに差分更新を行うストリーミング更新方式をとっていると推測されます。実装は軽量で、ツールの登録（Tool: codex_search）とコマンドハンドラ（/codex-search）を用意するだけで統合できるため、Piのエージェントワークフローに容易に組み込めます。拡張の注意点としては、ローカルにCodexが必要である点、出力の安定性（JSONLの行単位整合性）、および長時間の検索でのタイムアウトやエラー処理が挙げられます。将来的には出力の正規化、結果のキャッシュ、検索クエリ最適化、テストや監査ログの追加が有用です。（約700字）

プロジェクトの構成

主要なファイルとディレクトリ：

  • .agents: dir
  • .gitignore: file
  • README.md: file
  • demos: dir
  • extensions: dir

…他 4 ファイル

プロジェクトはシンプルな構成で、デモGIFや拡張本体が分かれており、Piのエージェント設定やツール登録に必要な最小限のファイルが揃っています。TypeScriptベースのコードは、Piの拡張テンプレートに沿って実装されている想定です。

使い方（概要）

  1. リポジトリをPi環境のextensionsディレクトリに配置またはインストール。
  2. 必要に応じてCodexが実行可能な環境（ローカルもしくは指定のパス）を用意。
  3. Piを再起動して /codex-search <質問> をチャット内で実行。
  4. 実行中は経過時間と検索/ページカウントがライブで更新され、終了後にJSON形式の結果を受け取る。

（詳細な設定・起動フラグはREADMEの記載に従ってください。）

改善提案（開発者向け）

  • エラーハンドリングとタイムアウト制御の強化（長時間検索への対応）
  • JSONLパースの堅牢化とスキーマ定義（出力の安定性向上）
  • 結果の要約・ランキング処理を組み込み、ユーザー表示を改善
  • テストケース・CI、導入手順のドキュメント充実

まとめ

Pi上で安全にCodexウェブ調査を実行できる、実用的でシンプルな拡張です。

リポジトリ情報：

READMEの抜粋：

pi-codex-search

Pi extension package that exposes Codex web research as a native Pi tool.

What it adds

  • Tool: codex_search
  • Command: /codex-search <question>
  • Live progress updates: elapsed time + search/page counters while Codex runs

Demo

codex_search live progress demo

The tool runs Codex in a locked search profile:

  • codex --search exec
  • --ephemeral
  • --skip-git-repo-check
  • --sandbox read-only
  • --json (JSONL …