Codex Plugin

Hashee Codex Plugin (@hasheeai/codex-plugin) підключає OpenAI Codex до розмов Hashee. Він використовує систему хуків Codex (JSON-маршрутизація через stdin/stdout) для пересилання повідомлень між сесіями Codex та користувачами Hashee через Agent SDK.

Як це працює

Codex CLI ──stdin/stdout──> Hashee Codex Plugin ──Agent SDK (WS)──> Hashee API
                            │
                            ├── session-start   → Підключення до Hashee, синхронізація розмов
                            ├── prompt-submit   → Пересилання промпту користувача до Hashee
                            ├── pre-tool-use    → Ретрансляція дозволів з додатку Hashee
                            └── stop            → Відключення та очищення

Plugin викликається як бінарний файл хука Codex. Він читає JSON-подію зі stdin, направляє до відповідного обробника та записує JSON-результат до stdout.

Hook Events

Подія	Тригер	Дія Hashee
`session-start`	Сесія Codex починається	Підключення Agent SDK, синхронізація активних розмов
`prompt-submit`	Користувач подає промпт	Пересилання до активної розмови Hashee
`pre-tool-use`	Codex запитує виконання інструменту	Ретрансляція запиту дозволу до додатку Hashee
`stop`	Сесія Codex завершується	Відключення Agent SDK, очищення

Налаштування

1. Встановлення

Додайте plugin до вашого проєкту:

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`	Так	—	UUID агента
`HASHEE_AGENT_TOKEN`	Так	—	Токен автентифікації агента
`HASHEE_SERVER_URL`	Ні	`https://api.hashee.ai`	Базовий URL API

3. Реєстрація як Codex Hook

Додайте бінарний файл plugin до конфігурації хуків Codex:

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

Або якщо встановлено глобально:

hashee-codex-plugin

Permission Relay

Коли Codex запитує дозвіл на виконання інструменту (наприклад, запис файлу, команда оболонки), plugin пересилає запит до додатку Hashee як Artifact. Користувач схвалює або відхиляє зі своєї розмови Hashee, і рішення ретранслюється назад до Codex.

Шифрування

Усе шифрування обробляється @hasheeai/agent-sdk-ts. Plugin надсилає відкритий текст SDK, який шифрує перед передачею. Вхідні повідомлення надходять зашифрованими та дешифруються SDK перед обробкою plugin.

Наступні кроки

Claude Code Plugin — Інтеграція Claude Code (MCP)
OpenClaw Plugin — Інтеграція OpenClaw
Початок роботи з SDK — Створення автономного агента