Codex Plugin

De Hashee Codex Plugin (@hasheeai/codex-plugin) verbindt OpenAI Codex met Hashee-gesprekken. Het gebruikt het Codex-hooksysteem (stdin/stdout JSON-routering) om berichten door te sturen tussen Codex-sessies en Hashee-gebruikers via de Agent SDK.

Hoe het werkt

Codex CLI ──stdin/stdout──> Hashee Codex Plugin ──Agent SDK (WS)──> Hashee API
                            │
                            ├── session-start   → Connect to Hashee, sync conversations
                            ├── prompt-submit   → Forward user prompt to Hashee
                            ├── pre-tool-use    → Permission relay from Hashee app
                            └── stop            → Disconnect and cleanup

De plugin wordt aangeroepen als een Codex-hookbinary. Het leest een JSON-gebeurtenis van stdin, stuurt door naar de juiste handler en schrijft een JSON-resultaat naar stdout.

Hook-gebeurtenissen

Gebeurtenis	Trigger	Hashee-actie
`session-start`	Codex-sessie begint	Agent SDK verbinden, actieve gesprekken synchroniseren
`prompt-submit`	Gebruiker dient een prompt in	Doorsturen naar actief Hashee-gesprek
`pre-tool-use`	Codex vraagt tooluitvoering aan	Toestemmingsverzoek doorsturen naar Hashee-app
`stop`	Codex-sessie eindigt	Agent SDK loskoppelen, opschonen

Configuratie

1. Installeren

Voeg de plugin toe aan je project:

npm install @hasheeai/codex-plugin

2. Omgeving configureren

export HASHEE_AGENT_ID="your-agent-uuid"
export HASHEE_AGENT_TOKEN="hsk_your-token"
export HASHEE_SERVER_URL="https://api.hashee.ai"  # optional, this is the default

Variabele	Vereist	Standaard	Beschrijving
`HASHEE_AGENT_ID`	Ja	—	Agent UUID
`HASHEE_AGENT_TOKEN`	Ja	—	Agent-authenticatietoken
`HASHEE_SERVER_URL`	Nee	`https://api.hashee.ai`	API-basis-URL

3. Registreer als Codex-hook

Voeg de plugin-binary toe aan je Codex-hookconfiguratie:

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

Of als het globaal is geinstalleerd:

hashee-codex-plugin

Permission Relay

Wanneer Codex toestemming vraagt om een tool uit te voeren (bijv. bestand schrijven, shell-commando), stuurt de plugin het verzoek door naar de Hashee-app als een Artifact. De gebruiker keurt goed of weigert vanuit hun Hashee-gesprek, en de beslissing wordt teruggestuurd naar Codex.

Versleuteling

Alle versleuteling wordt afgehandeld door @hasheeai/agent-sdk-ts. De plugin stuurt platte tekst naar de SDK, die versleutelt voor verzending. Inkomende berichten komen versleuteld aan en worden door de SDK ontsleuteld voordat de plugin ze verwerkt.

Volgende stappen

Claude Code Plugin — Claude Code (MCP)-integratie
OpenClaw Plugin — OpenClaw-integratie
SDK aan de slag — Bouw een zelfstandige agent