Codex Plugin

O Hashee Codex Plugin (@hasheeai/codex-plugin) conecta o OpenAI Codex a conversas do Hashee. Usa o sistema de hooks do Codex (roteamento JSON stdin/stdout) para encaminhar mensagens entre sessoes Codex e usuarios Hashee via Agent SDK.

Como Funciona

Codex CLI ──stdin/stdout──> Hashee Codex Plugin ──Agent SDK (WS)──> Hashee API
                            │
                            ├── session-start   → Conectar ao Hashee, sincronizar conversas
                            ├── prompt-submit   → Encaminhar prompt do usuario ao Hashee
                            ├── pre-tool-use    → Relay de permissao do app Hashee
                            └── stop            → Desconectar e limpar

O plugin e invocado como um binario de hook do Codex. Le um evento JSON do stdin, despacha para o handler apropriado e escreve um resultado JSON no stdout.

Eventos de Hook

Evento	Gatilho	Acao no Hashee
`session-start`	Sessao Codex comeca	Conectar Agent SDK, sincronizar conversas ativas
`prompt-submit`	Usuario envia um prompt	Encaminhar para conversa Hashee ativa
`pre-tool-use`	Codex solicita execucao de ferramenta	Encaminhar solicitacao de permissao ao app Hashee
`stop`	Sessao Codex termina	Desconectar Agent SDK, limpar

Configuracao

1. Instalar

Adicione o plugin ao seu projeto:

npm install @hasheeai/codex-plugin

2. Configurar Ambiente

export HASHEE_AGENT_ID="your-agent-uuid"
export HASHEE_AGENT_TOKEN="hsk_your-token"
export HASHEE_SERVER_URL="https://api.hashee.ai"  # opcional, este e o padrao

Variavel	Obrigatorio	Padrao	Descricao
`HASHEE_AGENT_ID`	Sim	—	UUID do agente
`HASHEE_AGENT_TOKEN`	Sim	—	Token de autenticacao do agente
`HASHEE_SERVER_URL`	Nao	`https://api.hashee.ai`	URL base da API

3. Registrar como Hook do Codex

Adicione o binario do plugin a configuracao de hook do Codex:

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

Ou se instalado globalmente:

hashee-codex-plugin

Permission Relay

Quando o Codex solicita permissao para executar uma ferramenta (ex.: escrita de arquivo, comando shell), o plugin encaminha a solicitacao ao app Hashee como um Artifact. O usuario aprova ou nega na conversa Hashee, e a decisao e retransmitida ao Codex.

Criptografia

Toda a criptografia e gerenciada pelo @hasheeai/agent-sdk-ts. O plugin envia texto simples ao SDK, que criptografa antes da transmissao. Mensagens recebidas chegam criptografadas e sao descriptografadas pelo SDK antes do plugin processa-las.

Proximos Passos

Claude Code Plugin — Integracao Claude Code (MCP)
OpenClaw Plugin — Integracao OpenClaw
SDK - Primeiros Passos — Construa um agente standalone