From 6fc826b309145df7c44b4f4c14d75952ccd1e709 Mon Sep 17 00:00:00 2001
From: Amir Benvenisti <128422269+starfleeth@users.noreply.github.com>
Date: Tue, 14 Apr 2026 13:03:58 -0700
Subject: [PATCH] Improve installation instructions with step-by-step guide

Replace the vague install instructions with a clear numbered walkthrough
that was tested end-to-end. Adds explicit steps for copying plugin and
marketplace files, and documents how to find and install the plugin in
the Codex UI.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 README.md | 35 ++++++++++++++++++++++++++++-------
 1 file changed, 28 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index b9df1d6..110493f 100644
--- a/README.md
+++ b/README.md
@@ -10,17 +10,38 @@ This repository provides an [OpenAI Codex plugin](https://developers.openai.com/
 
 ### Repo-scoped (recommended)
 
-Clone this repo into your project and Codex will discover the plugin via the marketplace file at `.agents/plugins/marketplace.json`:
+Add the plugin to an existing project so everyone on the repo gets access:
 
-```bash
-git clone https://github.com/temporalio/codex-temporal-plugin.git
-```
+1. Clone this repo into your project root:
 
-Restart Codex, open the plugin directory, and install **Temporal Developer** from the marketplace.
+   ```bash
+   cd your-project
+   git clone https://github.com/temporalio/codex-temporal-plugin.git
+   ```
 
-### Personal
+2. Copy the marketplace and plugin files into your project:
+
+   ```bash
+   # 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 the `temporal-developer` entry from the one in this repo into your existing file's `plugins` array.
+
+3. Optionally, remove the cloned repo:
+
+   ```bash
+   rm -rf codex-temporal-plugin
+   ```
+
+4. Restart Codex and open the plugin directory. In the marketplace dropdown, switch from **OpenAI** to **Temporal Developer**, then click the **+** button to install the plugin.
 
-To install for all projects, copy the plugin to `~/.codex/plugins/` and add an entry to `~/.agents/plugins/marketplace.json`.
 
 ## What's Included