Skip to content

Describe both plugins, list them for Codex too, and keep the two lists in step - #59

Merged
tezpark merged 9 commits into
mainfrom
docs/tez/readme-and-listing-fields
Nov 18, 2026
Merged

tezpark merged 9 commits into
mainfrom
docs/tez/readme-and-listing-fields

Conversation

@tezpark

@tezpark tezpark commented Nov 17, 2026 •

Copy link
Copy Markdown
Collaborator

Problem

  • The README listed the two plugins and the install commands, but not what each plugin does, which one to install, how updates arrive, or where to get support.
  • Both entries use non-relative sources (git-subdir and npm), so before install Claude Code shows only the entry's own fields. The plugin list showed a description and nothing else.
  • The repository had only the Claude Code list, so it looked like a Claude Code-only marketplace even though Codex can install from it.

Fix

  • README: plugin table with what each does and its documentation, a "which one do I need" guide, install for Claude Code, Codex, and a whole team, how to keep plugins up to date, each plugin's requirements, how this list is maintained, security, support, and license.
  • sendbird-client entry: displayName, author, homepage, repository, license, keywords (the same values as its plugin.json) and category: development.
  • sendbird-cli entry: displayName: Sendbird CLI, author, homepage, and category: development.
  • Both entries' homepage is https://tools.docs.sendbird.com/.
  • .agents/plugins/marketplace.json: the Codex list, with the same plugins, sources, and pins, plus Codex's policy (AVAILABLE, ON_INSTALL) and category.
  • Codex ignores the Claude Code file once its own file exists, so the Codex list now follows the Claude Code list automatically. Edit only .claude-plugin/marketplace.json. On a pull request from this repository, the check-marketplaces workflow runs scripts/sync-codex-marketplace.sh, which copies each plugin's name and source into the Codex list and keeps its Codex-only policy and category. The workflow pushes that commit to the pull request's branch with [skip ci] and then runs scripts/check-marketplaces.sh. On a fork pull request it cannot push, so the check fails and names the script to run.

Sources and pins are unchanged.

Verification

  • claude plugin validate . passes.
  • Codex 0.169.0, with an empty CODEX_HOME, reads .agents/plugins/marketplace.json and lists both plugins with the same sources and pins.
  • scripts/check-marketplaces.sh passes on this branch and fails, with a diff, when the Codex list pins @sendbird/cli 0.5.0 instead of 0.5.1.
  • scripts/sync-codex-marketplace.sh on a copy: raising sendbird-cli to 0.5.2 in the Claude Code list carries 0.5.2 into the Codex list with Productivity kept; a new plugin gets the default policy and Developer Tools; removing it removes it from the Codex list.
  • On this pull request: after a commit that only reversed the Codex list's order, the workflow pushed a sync commit as github-actions[bot] that restored it. With [skip ci], that commit started no second run.
  • Every link in the README returns 200, except npmjs.com, which blocks scripted requests.

From the next sendbird-client release on, its release automation writes the same display fields and updates the pin in both lists. A sendbird-cli release still edits only the Claude Code list, as before; the workflow updates the Codex list.

This branch carries two test commits that only reorder the Codex list and the bot's sync commits that undo them. Please squash-merge it.

🤖 Generated with Claude Code

…ields

The README now says what each plugin does and which one to install, how to install it in
Claude Code and Codex or for a whole team, how updates arrive, what each plugin needs, how
this list is maintained, and where to get support.

Both entries are non-relative sources, so before install Claude Code shows only the entry's
own fields. Each entry now carries its display name, author, homepage, and category; the
sendbird-client entry also carries its repository, license, and keywords, the same values as
its plugin.json.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Nov 17, 2026 •

Copy link
Copy Markdown
Codex Review Summary: ✅ Completed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-17T17:09:54.610037Z 2b75a30 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@upwind-code-us

upwind-code-us Bot commented Nov 17, 2026 •

Copy link
Copy Markdown

Upwind Code Scan

Upwind code scan | ✅ Passed

✅ No new findings in this PR vs main

Scan New in this PR Fixed Status
SCA 0 0 ✅ Passed
Secrets 0 0 ✅ Passed
IaC 0 0 ✅ Passed
SAST 0 0 ✅ Passed

View full scan details in Upwind Console →

Scan history (5 commits)
Commit Scanned at SCA new / fixed Secrets IaC SAST
2b75a30 2026-11-17 17:08 UTC 0 / 0 0 / 0 0 / 0 0 / 0
64bbc21 2026-11-18 02:07 UTC 0 / 0 0 / 0 0 / 0 0 / 0
a8527ff 2026-11-18 02:41 UTC 0 / 0 0 / 0 0 / 0 0 / 0
9e61ba8 2026-11-18 02:44 UTC 0 / 0 0 / 0 0 / 0 0 / 0
f8c7f37 (latest) 2026-11-18 03:58 UTC 0 / 0 0 / 0 0 / 0 0 / 0

Last updated: f8c7f37 · 2026-11-18 03:59 UTC

Codex reads .agents/plugins/marketplace.json when it exists, so the marketplace now has a
Codex list next to the Claude Code one: the same plugins and pins, plus the install policy
and category Codex asks for. Codex ignores the Claude Code file once its own file exists,
so scripts/check-marketplaces.sh compares the two lists and the check-marketplaces workflow
runs it on every pull request that touches them.

Both entries now point their homepage at https://tools.docs.sendbird.com/. The README
describes the two files, the check, and the new layout.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@tezpark tezpark changed the title Describe both plugins in the README and give each entry its display fields Describe both plugins, list them for Codex too, and keep the two lists in step Nov 18, 2026
tezpark and others added 3 commits November 18, 2026 11:41
People and release automation edit only the Claude Code list. scripts/sync-codex-marketplace.sh
rewrites the Codex list from it, copying each plugin's name and source and keeping the
Codex-only policy and category. On a pull request from this repository, the
check-marketplaces workflow runs it and pushes the result to the pull request's branch, so a
CLI version bump no longer needs a second edit. The check then confirms the two lists match.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Comment on lines +28 to +36
run: |
bash scripts/sync-codex-marketplace.sh
if ! git diff --quiet -- .agents/plugins/marketplace.json; then
git config user.name "github-actions[bot]"
git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
git add .agents/plugins/marketplace.json
git commit -m "Sync the Codex marketplace list with the Claude Code list"
git push origin "HEAD:${{ github.head_ref }}"
fi

@semgrep-code-sendbird semgrep-code-sendbird Bot Nov 18, 2026 •

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🟠 High severity issue identified in your code:

Using variable interpolation ${{...}} with github context data in a run: step could allow an attacker to inject their own code into the runner. This would allow them to steal secrets and code. github context data can have arbitrary user input and should be treated as untrusted. Instead, use an intermediate environment variable with env: to store the data and use the environment variable in the run: script. Be sure to use double-quotes the environment variable, like this: "$ENVVAR". Sendbird github secuirty guide: [https://sendbird.atlassian.net/wiki/spaces/security/pages/3163324422/Security+Best+practice+for+GitHub+Actions]

🌟 Fixed in commit 9e61ba8 🌟

Comment on lines +28 to +36
run: |
bash scripts/sync-codex-marketplace.sh
if ! git diff --quiet -- .agents/plugins/marketplace.json; then
git config user.name "github-actions[bot]"
git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
git add .agents/plugins/marketplace.json
git commit -m "Sync the Codex marketplace list with the Claude Code list"
git push origin "HEAD:${{ github.head_ref }}"
fi

@semgrep-code-sendbird semgrep-code-sendbird Bot Nov 18, 2026 •

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🟠 High severity issue identified in your code:

Using variable interpolation ${{...}} with github context data in a run: step could allow an attacker to inject their own code into the runner. This would allow them to steal secrets and code. github context data can have arbitrary user input and should be treated as untrusted. Instead, use an intermediate environment variable with env: to store the data and use the environment variable in the run: script. Be sure to use double-quotes the environment variable, like this: "$ENVVAR". Sendbird github secuirty guide: [https://sendbird.atlassian.net/wiki/spaces/security/pages/3163324422/Security+Best+practice+for+GitHub+Actions]

⭐ Fixed in commit 9e61ba8 ⭐

Comment on lines +30 to +38
run: |
bash scripts/sync-codex-marketplace.sh
if ! git diff --quiet -- .agents/plugins/marketplace.json; then
git config user.name "github-actions[bot]"
git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
git add .agents/plugins/marketplace.json
git commit -m "Sync the Codex marketplace list with the Claude Code list [skip ci]"
git push origin "HEAD:${{ github.head_ref }}"
fi

@semgrep-code-sendbird semgrep-code-sendbird Bot Nov 18, 2026 •

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🟠 High severity issue identified in your code:

Using variable interpolation ${{...}} with github context data in a run: step could allow an attacker to inject their own code into the runner. This would allow them to steal secrets and code. github context data can have arbitrary user input and should be treated as untrusted. Instead, use an intermediate environment variable with env: to store the data and use the environment variable in the run: script. Be sure to use double-quotes the environment variable, like this: "$ENVVAR". Sendbird github secuirty guide: [https://sendbird.atlassian.net/wiki/spaces/security/pages/3163324422/Security+Best+practice+for+GitHub+Actions]

🧼 Fixed in commit f8c7f37 🧼

Comment on lines +30 to +38
run: |
bash scripts/sync-codex-marketplace.sh
if ! git diff --quiet -- .agents/plugins/marketplace.json; then
git config user.name "github-actions[bot]"
git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
git add .agents/plugins/marketplace.json
git commit -m "Sync the Codex marketplace list with the Claude Code list [skip ci]"
git push origin "HEAD:${{ github.head_ref }}"
fi

@semgrep-code-sendbird semgrep-code-sendbird Bot Nov 18, 2026 •

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🟠 High severity issue identified in your code:

Using variable interpolation ${{...}} with github context data in a run: step could allow an attacker to inject their own code into the runner. This would allow them to steal secrets and code. github context data can have arbitrary user input and should be treated as untrusted. Instead, use an intermediate environment variable with env: to store the data and use the environment variable in the run: script. Be sure to use double-quotes the environment variable, like this: "$ENVVAR". Sendbird github secuirty guide: [https://sendbird.atlassian.net/wiki/spaces/security/pages/3163324422/Security+Best+practice+for+GitHub+Actions]

🌟 Fixed in commit f8c7f37 🌟

…ation

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@dodonmountain dodonmountain left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

LGTM

@tezpark
tezpark merged commit 5a10894 into main Nov 18, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants