From 4791b650989fd5569df1baeec42ebf2244b0d877 Mon Sep 17 00:00:00 2001
From: igalshilman <igal@restate.dev>
Date: Tue, 29 Sep 2026 19:29:40 +0200
Subject: [PATCH] Add native Codex plugin metadata and installation
 instructions

---
 README.md                                     | 29 ++++++++++++++---
 .../restate-agent/.codex-plugin/plugin.json   | 31 +++++++++++++++++++
 2 files changed, 55 insertions(+), 5 deletions(-)
 create mode 100644 plugins/restate-agent/.codex-plugin/plugin.json

diff --git a/README.md b/README.md
index ef314cc..a1d5712 100644
--- a/README.md
+++ b/README.md
@@ -195,17 +195,36 @@ stream to Restate. That append is the only persistence a step needs.
 - `restate-gen-sdk`: how to write the generator-SDK code the agent is built
   from.
 
-The plugin also connects the Restate docs MCP server. Claude Code offers to
-install it when you open this repository. You can also install it by hand:
+The plugin bundles both skills and the Restate docs MCP server. Codex and
+Claude Code share the same skill files and MCP configuration.
+
+For Codex, install the plugin from a terminal:
+
+```sh
+codex plugin marketplace add restatedev/agent
+codex plugin add restate-agent@restate-agent
+```
+
+Start a new Codex chat after installation. Opening the repository alone does
+not enable the plugin. To install from a local checkout, run
+`codex plugin marketplace add .` from the repository root instead of the
+first command above. Codex supports the existing
+[marketplace catalog](.claude-plugin/marketplace.json) and uses the
+[Codex manifest](plugins/restate-agent/.codex-plugin/plugin.json) to load the
+skills and MCP server.
+
+Claude Code offers to install the plugin when you open this repository.
+You can also install it by hand:
 
 ```sh
-# Claude Code
 /plugin marketplace add restatedev/agent
 /plugin install restate-agent@restate-agent
-# Other coding agents
-npx skills add restatedev/agent
 ```
 
+For other coding agents, install just the skills with
+`npx skills add restatedev/agent`. That command does not configure the
+Restate docs MCP server.
+
 ## Quickstart
 
 You need Node.js 22+, pnpm, the Restate server and CLI, and an OpenAI API key.
diff --git a/plugins/restate-agent/.codex-plugin/plugin.json b/plugins/restate-agent/.codex-plugin/plugin.json
new file mode 100644
index 0000000..f614e4e
--- /dev/null
+++ b/plugins/restate-agent/.codex-plugin/plugin.json
@@ -0,0 +1,31 @@
+{
+  "name": "restate-agent",
+  "version": "0.0.1",
+  "description": "Extend the Restate reference agent: tools, handlers, and growing it into a full application, with the generator SDK skill it builds on.",
+  "author": {
+    "name": "Restate"
+  },
+  "homepage": "https://restate.dev",
+  "repository": "https://github.com/restatedev/agent",
+  "keywords": [
+    "restate",
+    "durable-execution",
+    "ai-agents",
+    "generators"
+  ],
+  "mcpServers": "./.mcp.json",
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "Restate Agent",
+    "shortDescription": "Build durable agents with Restate.",
+    "longDescription": "Extend the Restate reference agent and compose durable services with the generator-based TypeScript SDK. Includes both coding skills and the Restate documentation MCP server.",
+    "developerName": "Restate",
+    "category": "Developer Tools",
+    "capabilities": [],
+    "websiteURL": "https://restate.dev",
+    "defaultPrompt": [
+      "Help me extend the Restate agent.",
+      "Help me build a service with the Restate generator SDK."
+    ]
+  }
+}