Codex Plugin

Hashee Codex Plugin (@hasheeai/codex-plugin) kết nối OpenAI Codex với hội thoại Hashee. Nó sử dụng hệ thống hook Codex (định tuyến JSON stdin/stdout) để chuyển tiếp tin nhắn giữa phiên Codex và người dùng Hashee qua Agent SDK.

Cách Hoạt Động

Codex CLI ──stdin/stdout──> Hashee Codex Plugin ──Agent SDK (WS)──> Hashee API
                            │
                            ├── session-start   → Kết nối Hashee, đồng bộ hội thoại
                            ├── prompt-submit   → Chuyển tiếp prompt đến Hashee
                            ├── pre-tool-use    → Chuyển tiếp quyền từ ứng dụng Hashee
                            └── stop            → Ngắt kết nối và dọn dẹp

Plugin được gọi dưới dạng hook binary Codex. Nó đọc sự kiện JSON từ stdin, gửi đến handler phù hợp và ghi kết quả JSON ra stdout.

Sự Kiện Hook

Sự kiện	Kích hoạt	Hành động Hashee
`session-start`	Phiên Codex bắt đầu	Kết nối Agent SDK, đồng bộ hội thoại
`prompt-submit`	Người dùng gửi prompt	Chuyển tiếp đến hội thoại Hashee
`pre-tool-use`	Codex yêu cầu thực thi công cụ	Chuyển tiếp yêu cầu quyền đến ứng dụng Hashee
`stop`	Phiên Codex kết thúc	Ngắt kết nối Agent SDK, dọn dẹp

Cài Đặt

1. Cài Đặt

Thêm plugin vào dự án:

npm install @hasheeai/codex-plugin

2. Cấu Hình Môi Trường

export HASHEE_AGENT_ID="your-agent-uuid"
export HASHEE_AGENT_TOKEN="hsk_your-token"
export HASHEE_SERVER_URL="https://api.hashee.ai"  # tùy chọn, đây là mặc định

Biến	Bắt buộc	Mặc định	Mô tả
`HASHEE_AGENT_ID`	Có	—	UUID Agent
`HASHEE_AGENT_TOKEN`	Có	—	Token xác thực agent
`HASHEE_SERVER_URL`	Không	`https://api.hashee.ai`	URL gốc API

3. Đăng Ký Codex Hook

Thêm plugin binary vào cấu hình hook Codex:

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

Hoặc nếu cài toàn cục:

hashee-codex-plugin

Permission Relay

Khi Codex yêu cầu quyền thực thi công cụ (ví dụ: ghi tệp, lệnh shell), plugin chuyển tiếp yêu cầu đến ứng dụng Hashee dưới dạng Artifact. Người dùng phê duyệt hoặc từ chối từ hội thoại Hashee, và quyết định được chuyển lại Codex.

Mã Hóa

Toàn bộ mã hóa do @hasheeai/agent-sdk-ts xử lý. Plugin gửi bản rõ cho SDK, SDK mã hóa trước khi truyền. Tin nhắn đến được SDK giải mã trước khi plugin xử lý.

Bước Tiếp Theo

Claude Code Plugin — Tích hợp Claude Code (MCP)
OpenClaw Plugin — Tích hợp OpenClaw
SDK Bắt Đầu — Xây agent độc lập