Codex Plugin

Hashee Codex Plugin（@hasheeai/codex-plugin）はOpenAI CodexをHasheeの会話に接続します。Codexのフックシステム（stdin/stdout JSONルーティング）を使用し、Agent SDK経由でCodexセッションとHasheeユーザー間のメッセージを転送します。

仕組み

Codex CLI ──stdin/stdout──> Hashee Codex Plugin ──Agent SDK (WS)──> Hashee API
                            │
                            ├── session-start   → Hasheeに接続、会話を同期
                            ├── prompt-submit   → ユーザープロンプトをHasheeに転送
                            ├── pre-tool-use    → Hasheeアプリからのパーミッションリレー
                            └── stop            → 切断とクリーンアップ

プラグインはCodexフックバイナリとして呼び出されます。stdinからJSONイベントを読み取り、適切なハンドラーにディスパッチし、stdoutにJSON結果を書き込みます。

フックイベント

イベント	トリガー	Hasheeアクション
`session-start`	Codexセッション開始	Agent SDKを接続、アクティブな会話を同期
`prompt-submit`	ユーザーがプロンプトを送信	アクティブなHashee会話に転送
`pre-tool-use`	Codexがツール実行をリクエスト	Hasheeアプリにパーミッションリクエストをリレー
`stop`	Codexセッション終了	Agent SDKを切断、クリーンアップ

セットアップ

1. インストール

プロジェクトにプラグインを追加します：

npm install @hasheeai/codex-plugin

2. 環境設定

export HASHEE_AGENT_ID="your-agent-uuid"
export HASHEE_AGENT_TOKEN="hsk_your-token"
export HASHEE_SERVER_URL="https://api.hashee.ai"  # オプション、デフォルト値

変数	必須	デフォルト	説明
`HASHEE_AGENT_ID`	はい	—	Agent UUID
`HASHEE_AGENT_TOKEN`	はい	—	エージェント認証トークン
`HASHEE_SERVER_URL`	いいえ	`https://api.hashee.ai`	APIベースURL

3. Codexフックとして登録

プラグインバイナリをCodexフック設定に追加します：

npx tsx packages/public/codex-plugin/src/index.ts

またはグローバルインストールの場合：

hashee-codex-plugin

パーミッションリレー

Codexがツール（ファイル書き込み、シェルコマンドなど）の実行パーミッションをリクエストすると、プラグインはアーティファクトとしてHasheeアプリにリクエストを転送します。ユーザーはHasheeの会話内で承認または拒否し、その判断がCodexにリレーバックされます。

暗号化

すべての暗号化は@hasheeai/agent-sdk-tsによって処理されます。プラグインはSDKに平文を送り、SDKが送信前に暗号化します。受信メッセージは暗号化された状態で到着し、プラグインが処理する前にSDKが復号します。

次のステップ

Claude Code Plugin — Claude Code（MCP）統合
OpenClaw Plugin — OpenClaw統合
SDK入門 — スタンドアロンエージェントの構築