Codex + Warp

Warp terminal integration for OpenAI Codex. This repo is a native Codex plugin marketplace for local/dev and Oz cloud-agent installs.

Layout

.agents/plugins/marketplace.json          Codex marketplace manifest, name: codex-warp
.github/workflows/test.yml                GitHub Actions shell test workflow
plugins/warp/.codex-plugin/plugin.json    Warp notification plugin manifest
plugins/warp/hooks/hooks.json             Warp notification hook config
plugins/warp/scripts/                     Warp notification hook scripts only
plugins/orchestration/.codex-plugin/plugin.json
plugins/orchestration/hooks/hooks.json
plugins/orchestration/scripts/            Oz parent-message listener, drain, and lifecycle scripts
plugins/orchestration/skills/             Oz orchestration skills
tests/test-hooks.sh                       Shell tests

Plugins

• warp: SessionStart, Stop, PermissionRequest, UserPromptSubmit, PostToolUse notifications for Warp.
• orchestration: SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd parent-message delivery for Codex child runs, plus Oz skills. Hook commands use ${PLUGIN_ROOT}/scripts/....

Local install

codex plugin marketplace add .
codex plugin add warp@codex-warp
codex plugin add orchestration@codex-warp

Testing

Fast shell suite:

bash tests/test-hooks.sh

This uses a fake oz CLI and a temp CODEX_HOME. It validates parent-message staging/drain/blocking and plugin manifests.

Versioning

plugins/warp/scripts/on-session-start.sh emits PLUGIN_VERSION. Current plugin version: 0.4.0. Keep it in sync with Warp's Codex plugin manager minimum version.

Requirements

• Codex CLI with plugin support
• jq

License

MIT — see LICENSE.