Skip to content

Commit cba7ba5

Browse files
committed
fix(codex): add canonical marketplace manifest and correct install docs
The previous Codex install flow was broken on two levels: 1. The README told users to run `codex plugin install dodopayments@dodopayments`, which is not a real Codex subcommand (Codex CLI 0.129+ only supports `codex plugin marketplace {add,upgrade,remove}`; plugin installation happens via the `/plugins` slash command inside the TUI). 2. After `codex plugin marketplace add` succeeded, the plugin still did not appear under `/plugins` because the repo only shipped a Claude-Code marketplace at `.claude-plugin/marketplace.json`. Codex prefers `.agents/plugins/marketplace.json` with its own schema (object `source`, required `policy` and `category` fields). The Claude-Code-shaped manifest was not a valid alternate layout for our split (`.codex-plugin/plugin.json`). Add `.agents/plugins/marketplace.json` pointing the `dodopayments` plugin at the repo root (`./`), where `.codex-plugin/plugin.json` already lives, and rewrite the README's Codex section to reflect the actual two-step flow. Closes #4
1 parent 3cebe97 commit cba7ba5

2 files changed

Lines changed: 40 additions & 3 deletions

File tree

.agents/plugins/marketplace.json

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
{
2+
"name": "dodopayments",
3+
"interface": {
4+
"displayName": "Dodo Payments"
5+
},
6+
"plugins": [
7+
{
8+
"name": "dodopayments",
9+
"source": {
10+
"source": "local",
11+
"path": "./"
12+
},
13+
"policy": {
14+
"installation": "AVAILABLE",
15+
"authentication": "ON_INSTALL"
16+
},
17+
"category": "Developer Tools"
18+
}
19+
]
20+
}

README.md

Lines changed: 20 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -26,13 +26,30 @@ The API MCP server uses browser OAuth by default, so no keys are required at ins
2626

2727
### Codex CLI
2828

29-
Codex reads `.claude-plugin/marketplace.json` natively, so the same repo works:
29+
Codex installs plugins in two steps: register the marketplace from your shell, then install the plugin from inside the Codex TUI.
30+
31+
1. Register the marketplace:
32+
33+
```bash
34+
codex plugin marketplace add dodopayments/dodo-agent-plugin
35+
```
36+
37+
2. Open Codex and run the `/plugins` slash command:
38+
39+
```bash
40+
codex
41+
```
42+
43+
Then type `/plugins`, switch to the **Dodo Payments** marketplace, select the **dodopayments** plugin, and choose **Install plugin**.
44+
45+
If you previously added the marketplace before this fix landed and the plugin doesn't appear under `/plugins`, refresh it:
3046
3147
```bash
32-
codex plugin marketplace add dodopayments/dodo-agent-plugin
33-
codex plugin install dodopayments@dodopayments
48+
codex plugin marketplace upgrade dodopayments
3449
```
3550
51+
> Codex CLI does not have a `codex plugin install` subcommand. Plugin installation always happens through the in-TUI `/plugins` flow ([official docs](https://developers.openai.com/codex/plugins)).
52+
3653
### Cursor
3754
3855
Manual install:

0 commit comments

Comments
 (0)