This repository provides an OpenAI Codex plugin for working with Temporal — developing applications, using the CLI, managing server, and working with Temporal Cloud.
Warning
This plugin is in Public Preview, and will continue to evolve and improve. We would love to hear your feedback - positive or negative - over in the Community Slack, in the #topic-ai channel
Add the plugin to an existing project so everyone on the repo gets access:
-
Clone this repo into your project root:
cd your-project git clone https://github.com/temporalio/codex-temporal-plugin.git -
Copy the marketplace and plugin files into your project:
# Create the directories Codex looks for at the repo root mkdir -p .agents/plugins plugins # Copy the plugin cp -r codex-temporal-plugin/plugins/temporal-developer plugins/ # Copy the marketplace catalog cp codex-temporal-plugin/.agents/plugins/marketplace.json .agents/plugins/
If you already have a
.agents/plugins/marketplace.json, merge thetemporal-developerentry from the one in this repo into your existing file'spluginsarray. -
Optionally, remove the cloned repo:
rm -rf codex-temporal-plugin
-
Restart Codex and open the plugin directory. In the marketplace dropdown, switch from OpenAI to Temporal, then click the + button to install the plugin.
- temporal-developer skill — Comprehensive guidance for developing Temporal applications: creating workflows, activities, and workers; handling signals, queries, and updates; debugging non-determinism errors; implementing saga patterns, versioning strategies, and testing approaches across Python, TypeScript, Go, and Java SDKs.
The skill content is derived from temporalio/skill-temporal-developer. If you only need the skill without the plugin wrapper, you can install it directly from that repo.
- Claude Code: See temporalio/claude-temporal-plugin
- Cursor: See temporalio/cursor-temporal-plugin
MIT