Skip to content

Align Codex marketplace docs and policy fields #149

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
fcakyon merged 1 commit into from
Apr 8, 2026
Merged

Align Codex marketplace docs and policy fields #149

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
63 changes: 42 additions & 21 deletions .agents/plugins/marketplace.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,8 @@
"path": "./plugins/anthropic-office-skills"
},
"policy": {
"installation": "AVAILABLE"
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "skills"
},
Expand All @@ -22,7 +23,8 @@
"path": "./plugins/openai-office-skills"
},
"policy": {
"installation": "AVAILABLE"
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "skills"
},
Expand All @@ -33,7 +35,8 @@
"path": "./plugins/react-skills"
},
"policy": {
"installation": "AVAILABLE"
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "development"
},
Expand All @@ -44,7 +47,8 @@
"path": "./plugins/agent-browser"
},
"policy": {
"installation": "AVAILABLE"
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "development"
},
Expand All @@ -55,7 +59,8 @@
"path": "./plugins/frontend-design-skills"
},
"policy": {
"installation": "AVAILABLE"
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "skills"
},
Expand All @@ -66,7 +71,8 @@
"path": "./plugins/mongodb-skills"
},
"policy": {
"installation": "AVAILABLE"
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "skills"
},
Expand All @@ -77,7 +83,8 @@
"path": "./plugins/supabase-skills"
},
"policy": {
"installation": "AVAILABLE"
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "skills"
},
Expand All @@ -88,7 +95,8 @@
"path": "./plugins/stripe-skills"
},
"policy": {
"installation": "AVAILABLE"
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "skills"
},
Expand All @@ -99,7 +107,8 @@
"path": "./plugins/polar-skills"
},
"policy": {
"installation": "AVAILABLE"
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "skills"
},
Expand All @@ -110,7 +119,8 @@
"path": "./plugins/livekit-skills"
},
"policy": {
"installation": "AVAILABLE"
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "skills"
},
Expand All @@ -121,7 +131,8 @@
"path": "./plugins/cloudflare-skills"
},
"policy": {
"installation": "AVAILABLE"
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "skills"
},
Expand All @@ -132,7 +143,8 @@
"path": "./plugins/web-performance-skills"
},
"policy": {
"installation": "AVAILABLE"
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "skills"
},
Expand All @@ -143,7 +155,8 @@
"path": "./plugins/hetzner-skills"
},
"policy": {
"installation": "AVAILABLE"
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "skills"
},
Expand All @@ -154,7 +167,8 @@
"path": "./plugins/github-dev"
},
"policy": {
"installation": "AVAILABLE"
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "development"
},
Expand All @@ -165,7 +179,8 @@
"path": "./plugins/ultralytics-dev"
},
"policy": {
"installation": "AVAILABLE"
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "productivity"
},
Expand All @@ -176,7 +191,8 @@
"path": "./plugins/azure-tools"
},
"policy": {
"installation": "AVAILABLE"
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "tools"
},
Expand All @@ -187,7 +203,8 @@
"path": "./plugins/claude-tools"
},
"policy": {
"installation": "AVAILABLE"
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "productivity"
},
Expand All @@ -198,7 +215,8 @@
"path": "./plugins/gcloud-tools"
},
"policy": {
"installation": "AVAILABLE"
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "tools"
},
Expand All @@ -209,7 +227,8 @@
"path": "./plugins/general-dev"
},
"policy": {
"installation": "AVAILABLE"
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "development"
},
Expand All @@ -220,7 +239,8 @@
"path": "./plugins/paper-search-tools"
},
"policy": {
"installation": "AVAILABLE"
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "tools"
},
Expand All @@ -231,7 +251,8 @@
"path": "./plugins/tavily-tools"
},
"policy": {
"installation": "AVAILABLE"
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "tools"
}
Expand Down
33 changes: 30 additions & 3 deletions CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -62,7 +62,7 @@ Docs:
| Tool | Path | Notes |
| ----------- | ---------------------------------- | ----------------------------------------------------------------------- |
| Claude Code | `.claude-plugin/marketplace.json` | local sources only (use sync scripts for external repos) |
| Codex CLI | `.agents/plugins/marketplace.json` | local sources only, needs `policy.installation` |
| Codex CLI | `.agents/plugins/marketplace.json` | local sources only; use `./`-prefixed `source.path` plus plugin `policy` fields |
| Cursor | `.cursor-plugin/marketplace.json` | local sources, needs `source` + `description` |
| Gemini CLI | none | per-plugin install: `gemini extensions install --path ./plugins/<name>` |

Expand All @@ -86,13 +86,40 @@ Docs:
{
"name": "<plugin-name>",
"source": { "source": "local", "path": "./plugins/<plugin-name>" },
"policy": { "installation": "AVAILABLE" },
"policy": { "installation": "AVAILABLE", "authentication": "ON_INSTALL" },
"category": "Development"
}
```

`source.path` must point to a local folder with a `./`-prefixed path relative to the marketplace root.

`policy.installation` values: `AVAILABLE`, `INSTALLED_BY_DEFAULT`, `NOT_AVAILABLE`.

`policy.authentication` controls whether auth happens on install or first use.

#### Codex CLI personal marketplace example

Use this only for generic Codex marketplace docs and maintainer examples. User-facing installation docs should stay specific to this repo's bundled marketplace.

```json
{
"name": "personal-plugins",
"interface": {
"displayName": "Personal Plugins"
},
"plugins": [
{
"name": "my-plugin",
"source": { "source": "local", "path": "./.codex/plugins/my-plugin" },
"policy": { "installation": "AVAILABLE", "authentication": "ON_INSTALL" },
"category": "development"
}
]
}
```

Store this at `~/.agents/plugins/marketplace.json`, keep plugin folders under `~/.codex/plugins/`, and keep every `source.path` `./`-prefixed relative to the marketplace root.

#### Cursor marketplace entry

```json
Expand Down Expand Up @@ -212,7 +239,7 @@ Commands are Claude Code only. Gemini CLI uses TOML commands. Other tools use sk

```
Claude Code: /plugin marketplace add fcakyon/claude-codex-settings
Codex CLI: codex plugin install <plugin-name>@claude-settings
Codex CLI: use .agents/plugins/marketplace.json or ~/.agents/plugins/marketplace.json, restart Codex, then install from /plugins
Cursor: import marketplace or /add-plugin
Gemini CLI: gemini extensions install --path ./plugins/<name>
```
Expand Down
18 changes: 18 additions & 0 deletions INSTALL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -55,6 +55,24 @@ Optionally install IDE extension:

- [Codex VSCode extension](https://developers.openai.com/codex/ide) for IDE integration

### Codex Plugins

Codex installs plugins from local marketplaces rather than a direct shell install command.

#### Use This Repo in Codex

1. Clone this repo locally.
2. Open the repo in Codex. This repo already includes `.agents/plugins/marketplace.json`.
3. If Codex was already open when you added or changed that marketplace file, restart Codex.
4. In Codex, open `/plugins`.
5. Choose `Claude & Codex Settings` and install the plugins you want.

You do not need to create `~/.agents/plugins/marketplace.json` or copy plugin folders manually for this repo. The Codex marketplace is already part of the repository.

If `Claude & Codex Settings` does not appear in `/plugins`, make sure you opened the repo root that contains `.agents/plugins/marketplace.json`, then restart Codex.

For generic Codex marketplace examples and maintainer docs, see [CLAUDE.md](CLAUDE.md).

### Gemini CLI

Install Gemini CLI:
Expand Down
Loading
Loading