Skip to content
Merged
Changes from all commits
Commits
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
9 changes: 7 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,11 +65,16 @@ codex plugin install <plugin-name> --source awesome-codex-plugins
```

**Desktop App / IDE Extension:**
1. Open Codex settings → Plugins → Marketplace Sources
1. Open Codex settings → Plugins → Next to search plugins input click on menu and select → `+Add More...`
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

SUGGESTION: Instruction uses arrow symbols (→) as sentence separators, making it hard to read.

Consider breaking into clearer sentences, e.g.:
"Open Codex settings → Plugins. Next to the search input, click the menu and select +Add More...."

The current run-on style hurts scanability.

<img width="1462" height="466" alt="image" src="https://github.com/user-attachments/assets/ae15f505-58a8-4199-bb7b-56a07b670b10" />
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

SUGGESTION: Image embedded via user-attachment URL (github.com/user-attachments/...).

These URLs are not permanent across forks or if the user deletes their attachment. For long-lived documentation, commit images to the repository and reference via relative paths.



2. Add this URL:
```
https://raw.githubusercontent.com/hashgraph-online/awesome-codex-plugins/main/.agents/plugins/marketplace.json
https://github.com/hashgraph-online/awesome-codex-plugins.git
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

CRITICAL: Invalid marketplace source URL.

https://github.com/hashgraph-online/awesome-codex-plugins.git is a GitHub repository page URL, not a Codex marketplace source.

Codex expects a direct URL to a marketplace.json file. The correct URL is:

Suggested change
https://github.com/hashgraph-online/awesome-codex-plugins.git
https://raw.githubusercontent.com/hashgraph-online/awesome-codex-plugins/main/.agents/plugins/marketplace.json

Using the repository URL will cause plugin installation to fail.

```
<img width="1974" height="1064" alt="image" src="https://github.com/user-attachments/assets/ffbae59f-41ae-4ee3-9d52-864273ecdcb3" />
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

SUGGESTION: Second user-attachment image (same portability concern as the previous image).

Consider committing these screenshots to the repository assets and referencing them with stable relative paths.


3. The curated plugin list appears as an available marketplace source.

Each plugin entry includes a `source.path` pointing at a mirrored bundle under `./plugins/` in this repo, so installations are fast and reproducible without hitting upstream repos at install time.
Expand Down