This repository is the official Codex marketplace for Ambush AI. It currently publishes the Ambush Streams plugin, which connects Codex to the production Ambush MCP server and teaches Codex how to manage personalized news streams, per-event processing, and delivery safely.
This repository is intentionally separate from the other Ambush distribution formats:
- ambush-stream-skills is the skills.sh package.
- claude-plugins is the Claude Code plugin marketplace.
- This repository is the Codex plugin marketplace.
Add the marketplace:
codex plugin marketplace add Ambush-AI/codex-plugins --ref mainInstall Ambush Streams:
codex plugin add ambush-streams@ambush-aiRestart Codex if it is already open. When prompted, connect your Ambush account through OAuth. You can then ask Codex to create, list, update, process, route, pause, resume, or permanently delete a stream, or review its emitted news items.
.agents/plugins/marketplace.json
plugins/
ambush-streams/
.codex-plugin/plugin.json
.mcp.json
assets/
skills/
submission/
The marketplace and plugin use Ambush Streams everywhere consumers see the product name. The production MCP API still exposes legacy tool identifiers such as list_feeds and create_feed; the bundled skill maps those identifiers to stream terminology.
Validate the plugin package with Codex's plugin-creator validator:
python3 /path/to/plugin-creator/scripts/validate_plugin.py plugins/ambush-streamsTest this checkout as a local marketplace:
codex plugin marketplace add /absolute/path/to/codex-plugins
codex plugin add ambush-streams@ambush-aiRemove the local test installation with:
codex plugin remove ambush-streams@ambush-ai
codex plugin marketplace remove ambush-aiThe repository package is ready for local and team testing. Ambush Streams has not been submitted to OpenAI's public plugin directory. The remaining portal and reviewer steps are tracked in plugins/ambush-streams/submission/README.md.