Repository navigation
Describe both plugins, list them for Codex too, and keep the two lists in step #59
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.
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
Changes from all commits
2b75a30
64bbc21
3cc8f09
a8527ff
a5886ab
68f6b6f
9e61ba8
8e5d6d9
f8c7f37
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,37 @@ | ||
| { | ||
| "name": "sendbird", | ||
| "interface": { | ||
| "displayName": "Sendbird" | ||
| }, | ||
| "plugins": [ | ||
| { | ||
| "name": "sendbird-client", | ||
| "source": { | ||
| "source": "git-subdir", | ||
| "url": "https://github.com/sendbird/sendbird-client-plugin.git", | ||
| "path": "plugins/sendbird-client", | ||
| "ref": "v1.0.3", | ||
| "sha": "54f5136626954f723919102c2208e17641901e3e" | ||
| }, | ||
| "policy": { | ||
| "installation": "AVAILABLE", | ||
| "authentication": "ON_INSTALL" | ||
| }, | ||
| "category": "Developer Tools" | ||
| }, | ||
| { | ||
| "name": "sendbird-cli", | ||
| "source": { | ||
| "source": "npm", | ||
| "package": "@sendbird/cli", | ||
| "version": "0.5.1", | ||
| "registry": "https://registry.npmjs.org" | ||
| }, | ||
| "policy": { | ||
| "installation": "AVAILABLE", | ||
| "authentication": "ON_INSTALL" | ||
| }, | ||
| "category": "Productivity" | ||
| } | ||
| ] | ||
| } |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,42 @@ | ||
| # Claude Code reads .claude-plugin/marketplace.json and Codex reads .agents/plugins/marketplace.json. | ||
| # People and release automation edit only the Claude Code list. On a pull request from this | ||
| # repository, this job rewrites the Codex list from it and pushes that commit to the pull | ||
| # request's branch, so a release PR such as a CLI version bump needs nothing more. A pull | ||
| # request from a fork cannot be pushed to; there the check fails and names the script to run. | ||
| # The sync commit says [skip ci]: this job already checked the synced lists, and a run started | ||
| # by the bot's own push would wait for a maintainer's approval. | ||
| name: check-marketplaces | ||
| on: | ||
| pull_request: | ||
| paths: [".claude-plugin/**", ".agents/**", "scripts/*marketplace*.sh", ".github/workflows/check-marketplaces.yml"] | ||
| push: | ||
| branches: [main] | ||
| permissions: | ||
| contents: read | ||
| concurrency: | ||
| group: check-marketplaces-${{ github.head_ref || github.ref }} | ||
| cancel-in-progress: true | ||
| jobs: | ||
| check: | ||
| runs-on: ubuntu-latest | ||
| permissions: | ||
| contents: write | ||
| steps: | ||
| - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4 | ||
| with: | ||
| ref: ${{ github.event_name == 'pull_request' && github.head_ref || github.ref }} | ||
| - name: Bring the Codex list in step with the Claude Code list | ||
| if: github.event_name == 'pull_request' && github.event.pull_request.head.repo.full_name == github.repository | ||
| env: | ||
| HEAD_REF: ${{ github.head_ref }} | ||
| 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:refs/heads/$HEAD_REF" | ||
| fi | ||
|
Comment on lines
+32
to
+40
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
⭐ Fixed in commit 9e61ba8 ⭐
Comment on lines
+32
to
+40
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
🧼 Fixed in commit f8c7f37 🧼
Comment on lines
+32
to
+40
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
🌟 Fixed in commit f8c7f37 🌟 |
||
| - name: Both marketplace files list the same plugins and pins | ||
| run: bash scripts/check-marketplaces.sh | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,28 +1,154 @@ | ||
| # Sendbird plugins | ||
| # Sendbird plugins for Claude Code and Codex | ||
|
|
||
| This repository is the `sendbird` plugin marketplace. It holds only the list of plugins; each plugin's code, documentation, and license live in its own repository. The marketplace list (`.claude-plugin/marketplace.json`) and this README are licensed under the Apache License 2.0 ([LICENSE](LICENSE)). | ||
| This repository is the `sendbird` plugin marketplace. Add it once to Claude Code or Codex, and you can install Sendbird's plugins from it: | ||
|
|
||
| | Plugin | Repository | | ||
| - **`sendbird-client`** writes Sendbird Chat, UIKit, and Calls code into your iOS, Android, and JavaScript apps. | ||
| - **`sendbird-cli`** manages your Sendbird apps and Chat resources from your coding agent with the Sendbird CLI. | ||
|
|
||
| The repository holds only the list of plugins. Each plugin's code, documentation, and license live in its own source, and every entry in the list is pinned to one reviewed release. | ||
|
|
||
| Documentation: [tools.docs.sendbird.com/plugins](https://tools.docs.sendbird.com/plugins) | ||
|
|
||
| ## Plugins | ||
|
|
||
| | Plugin | What it does | Install id | Source | Documentation | | ||
| |---|---|---|---|---| | ||
| | Sendbird Client Plugin | Adds Sendbird Chat (including authentication and sessions), UIKit, and Calls to iOS (UIKit and SwiftUI), Android (View and Compose), and JavaScript (React and React Native) apps. It writes code from verified documentation and templates and checks it against the Sendbird SDK you have installed. | `sendbird-client@sendbird` | [sendbird/sendbird-client-plugin](https://github.com/sendbird/sendbird-client-plugin) | [Client plugin guide](https://tools.docs.sendbird.com/plugins/client) | | ||
| | Sendbird CLI | Signs you in to Sendbird and manages apps, Chat users, channels, messages, and webhooks through the Sendbird CLI. It does not write client code; for that it offers the client plugin. | `sendbird-cli@sendbird` | npm package [`@sendbird/cli`](https://www.npmjs.com/package/@sendbird/cli) | [CLI plugin guide](https://tools.docs.sendbird.com/plugins/cli) | | ||
|
|
||
| ### Which one do I need? | ||
|
|
||
| | You want to | Install | | ||
| |---|---| | ||
| | `sendbird-client` | [sendbird/sendbird-client-plugin](https://github.com/sendbird/sendbird-client-plugin) | | ||
| | `sendbird-cli` | [sendbird/sendbird-cli](https://github.com/sendbird/sendbird-cli) | | ||
| | Add chat, a chat UI, or voice and video calls to your own app | `sendbird-client` | | ||
| | Create or inspect Sendbird apps, users, channels, messages, or webhooks without opening the Dashboard | `sendbird-cli` | | ||
| | Both, for example set up an app and then build its chat screen | Both. Each plugin works on its own. | | ||
|
|
||
| Read a plugin's README before you install it. It says what the plugin runs on your machine and under which license it is provided. | ||
| Install only the plugins you need. | ||
|
|
||
| ## Install | ||
|
|
||
| ## Claude Code | ||
| ### Claude Code | ||
|
|
||
| ```bash | ||
| claude plugin marketplace add sendbird/sendbird-plugins | ||
| claude plugin install sendbird-client@sendbird | ||
| claude plugin install sendbird-cli@sendbird | ||
| ``` | ||
|
|
||
| ## Codex | ||
| You can also run `/plugin` inside a session, open **Marketplaces**, add `sendbird/sendbird-plugins`, and install a plugin from **Discover**. | ||
|
|
||
| Then try it in your project: | ||
|
|
||
| ```text | ||
| /sendbird-client:setup --product chat | ||
| ``` | ||
|
|
||
| ### Codex | ||
|
|
||
| ```bash | ||
| codex plugin marketplace add sendbird/sendbird-plugins | ||
| codex plugin add sendbird-client@sendbird | ||
| codex plugin add sendbird-cli@sendbird | ||
| ``` | ||
|
|
||
| Install only the plugins you need. | ||
| In Codex, call a skill with `$`, for example `$sendbird-client:setup`. Codex runs a plugin's hooks only after you trust them; the client plugin's README explains what its hooks do. | ||
|
|
||
| ### For a whole team | ||
|
|
||
| To have everyone who opens a repository see the `sendbird` marketplace, commit this to `.claude/settings.json` in that repository. It registers the marketplace and turns on auto-update; each teammate still installs the plugin once with `claude plugin install sendbird-client@sendbird --scope project`. | ||
|
|
||
| ```json | ||
| { | ||
| "extraKnownMarketplaces": { | ||
| "sendbird": { | ||
| "source": { "source": "github", "repo": "sendbird/sendbird-plugins" }, | ||
| "autoUpdate": true | ||
| } | ||
| } | ||
| } | ||
| ``` | ||
|
|
||
| The same entry in `~/.claude/settings.json` applies to you in every project, and in managed settings it applies to everyone in your organization. | ||
|
|
||
| ## Keep plugins up to date | ||
|
|
||
| Every entry in this marketplace points at one release and its commit, so what you install does not change until this list moves to a new release. Third-party marketplaces such as `sendbird` do not auto-update by default. | ||
|
|
||
| | To | Claude Code | Codex | | ||
| |---|---|---| | ||
| | Turn on auto-update | `/plugin` → **Marketplaces** → `sendbird` → **Enable auto-update**, or `"autoUpdate": true` in settings as above | — | | ||
| | Refresh the list | `claude plugin marketplace update sendbird` | `codex plugin marketplace upgrade sendbird` | | ||
| | Update an installed plugin | `claude plugin update sendbird-client@sendbird` | — | | ||
|
|
||
| Claude Code applies an update from your next session, or after `/reload-plugins`. | ||
|
|
||
| ## Sendbird Client Plugin | ||
|
|
||
| - **Products:** Chat (including authentication and sessions), UIKit, and Calls. | ||
| - **Platforms:** iOS (UIKit and SwiftUI), Android (View and Compose), JavaScript (React and React Native). | ||
| - **Every API it writes is checked.** Each Sendbird symbol in its answers and code is verified against the plugin's curated knowledge, the SDK installed in your project, public Sendbird sources, or [sendbird.com/docs](https://sendbird.com/docs). When it cannot verify something, it says so instead of guessing. | ||
| - **Requirements:** bash and [`jq`](https://jqlang.org). Nothing to configure at install; it asks for your App ID when it needs one. | ||
|
|
||
| Example prompts, typed in plain language in your project: | ||
|
|
||
| - "Add Sendbird Chat to this app so a signed-in user can open a group channel and send messages." | ||
| - "Show typing indicators and read receipts in the channel screen." | ||
| - "Why does connecting to Sendbird fail with error 400302?" | ||
| - "Upgrade the Sendbird Chat SDK to the latest 4.x version and fix what the upgrade breaks." | ||
| - "Let the signed-in user place 1:1 voice and video calls to another user and accept or decline incoming calls with Sendbird Calls." | ||
|
|
||
| The plugin runs local shell scripts as hooks. Before you install it, read [What runs on your machine](https://github.com/sendbird/sendbird-client-plugin#what-runs-on-your-machine): each script, what it reads and changes, and the network requests it makes. | ||
|
|
||
| ## Sendbird CLI | ||
|
|
||
| - **What it covers:** signing in and choosing a default organization and app, Chat users, channels, messages, project connection settings, webhooks, channel-type policies, and usage and plan information. | ||
| - **What it does not do:** it does not write client code in your app (use `sendbird-client` for that), and it does not place calls or manage Live. | ||
| - **Requirements:** Node.js 22.23.4 or later on 22.x, or 24.22.1 or later on 24.x. | ||
| - **Usage telemetry:** the CLI sends command names and outcome categories by default, never argument values, prompts, code, or tokens. Set `DO_NOT_TRACK=1` or run `sendbird telemetry disable` to turn it off. See the [CLI documentation](https://tools.docs.sendbird.com/plugins/cli). | ||
|
|
||
| Try it after install: | ||
|
|
||
| ```text | ||
| /sendbird-cli:sendbird-setup | ||
| ``` | ||
|
|
||
| ## How this marketplace is maintained | ||
|
|
||
| - The list is kept in two files with the same plugins and pins. Claude Code reads `.claude-plugin/marketplace.json`. Codex reads `.agents/plugins/marketplace.json`, which also carries Codex's install policy and category for each plugin. | ||
| - Edit only `.claude-plugin/marketplace.json`. Codex ignores that file once its own file exists, so on every pull request the `check-marketplaces` workflow rewrites the Codex list from it with [`scripts/sync-codex-marketplace.sh`](scripts/sync-codex-marketplace.sh), pushes that commit to the pull request's branch, and then checks that the two lists match with [`scripts/check-marketplaces.sh`](scripts/check-marketplaces.sh). The Codex list keeps its own install policy and category for each plugin. A pull request from a fork cannot be pushed to, so there you run the sync script yourself and commit the result. | ||
| - Each entry is pinned: `sendbird-client` to a release tag and its commit in [sendbird/sendbird-client-plugin](https://github.com/sendbird/sendbird-client-plugin), and `sendbird-cli` to an exact npm version. | ||
| - A new release reaches this list only through a pull request that the maintainers in [`.github/CODEOWNERS`](.github/CODEOWNERS) review. Each plugin release lists what changed. | ||
| - The plugin entries carry the plugin's display name, author, homepage, and category, because Claude Code shows only the list entry for a plugin that is not installed yet. | ||
|
|
||
| ```text | ||
| sendbird-plugins/ | ||
| ├── .claude-plugin/ | ||
| │ └── marketplace.json the plugin list Claude Code reads | ||
| ├── .agents/plugins/ | ||
| │ └── marketplace.json the same list for Codex | ||
| ├── .github/ | ||
| │ ├── CODEOWNERS who reviews changes to the lists | ||
| │ └── workflows/ | ||
| │ └── check-marketplaces.yml syncs the Codex list and checks both | ||
| ├── scripts/ | ||
| │ ├── sync-codex-marketplace.sh rewrites the Codex list from the Claude Code list | ||
| │ └── check-marketplaces.sh checks that the two lists match | ||
| ├── LICENSE Apache-2.0, for the list and this README | ||
| ├── README.md | ||
| └── SECURITY.md how to report a vulnerability | ||
| ``` | ||
|
|
||
| ## Security | ||
|
|
||
| Report a vulnerability privately; do not open a public issue. [SECURITY.md](SECURITY.md) says where to report a problem in a plugin and in this list. | ||
|
|
||
| ## Support | ||
|
|
||
| - **Client plugin:** [open an issue](https://github.com/sendbird/sendbird-client-plugin/issues) in its repository. | ||
| - **CLI, or your Sendbird account:** [Sendbird support](https://sendbird.com/support). | ||
| - **This list:** [open an issue](https://github.com/sendbird/sendbird-plugins/issues) here. | ||
|
|
||
| ## License | ||
|
|
||
| The marketplace lists (`.claude-plugin/marketplace.json` and `.agents/plugins/marketplace.json`), the scripts, and this README are licensed under the Apache License 2.0 ([LICENSE](LICENSE)). Each plugin comes with its own license: `sendbird-client` under Apache-2.0, and `sendbird-cli` under the terms in its npm package's `LICENSE`. |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,19 @@ | ||
| #!/usr/bin/env bash | ||
| # Claude Code reads .claude-plugin/marketplace.json; Codex reads .agents/plugins/marketplace.json | ||
| # when it exists and then ignores the Claude Code file. Both must list the same plugins with the | ||
| # same source and pin, or Codex users would install a different release than Claude Code users. | ||
| # Run it before you push a change to either file: bash scripts/check-marketplaces.sh [root] | ||
| set -euo pipefail | ||
| root="${1:-$(cd "$(dirname "$0")/.." && pwd)}" | ||
| claude="$root/.claude-plugin/marketplace.json" | ||
| codex="$root/.agents/plugins/marketplace.json" | ||
| pick='[.plugins[] | {name, source}] | sort_by(.name)' | ||
| if [ "$(jq -c "$pick" "$claude")" != "$(jq -c "$pick" "$codex")" ]; then | ||
| echo "The plugin lists differ. Run bash scripts/sync-codex-marketplace.sh and commit the result:" >&2 | ||
| diff <(jq "$pick" "$claude") <(jq "$pick" "$codex") >&2 || true | ||
| exit 1 | ||
| fi | ||
| [ "$(jq -r .name "$claude")" = "$(jq -r .name "$codex")" ] || { echo "The marketplace names differ." >&2; exit 1; } | ||
| missing="$(jq -r '.plugins[] | select(.policy.installation == null or .policy.authentication == null or .category == null) | .name' "$codex")" | ||
| [ -z "$missing" ] || { echo "Codex entries need policy.installation, policy.authentication, and category: $missing" >&2; exit 1; } | ||
| echo "Both marketplace files list the same $(jq '.plugins | length' "$claude") plugins with the same sources." |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,24 @@ | ||
| #!/usr/bin/env bash | ||
| # Rewrite .agents/plugins/marketplace.json from .claude-plugin/marketplace.json. | ||
| # The Claude Code list is the one people and release automation edit. This copies its plugin | ||
| # names and sources (with their pins) into the Codex list and keeps each plugin's Codex-only | ||
| # fields (policy, category). A plugin new to the Codex list gets the default policy and the | ||
| # "Developer Tools" category; a plugin removed from the Claude Code list is removed here too. | ||
| # Usage: bash scripts/sync-codex-marketplace.sh [root] | ||
| set -euo pipefail | ||
| root="${1:-$(cd "$(dirname "$0")/.." && pwd)}" | ||
| claude="$root/.claude-plugin/marketplace.json" | ||
| codex="$root/.agents/plugins/marketplace.json" | ||
| mkdir -p "$(dirname "$codex")" | ||
| [ -f "$codex" ] || echo '{"plugins":[]}' > "$codex" | ||
| tmp="$(mktemp)" | ||
| jq --indent 2 --slurpfile cx "$codex" ' | ||
| ($cx[0].plugins | map({key: .name, value: .}) | from_entries) as $old | ||
| | {name: .name, interface: ($cx[0].interface // {displayName: "Sendbird"}), | ||
| plugins: [.plugins[] | . as $p | ($old[$p.name] // {}) as $o | ||
| | {name: $p.name, source: $p.source, | ||
| policy: ($o.policy // {installation: "AVAILABLE", authentication: "ON_INSTALL"}), | ||
| category: ($o.category // "Developer Tools")}]}' "$claude" > "$tmp" | ||
| if cmp -s "$tmp" "$codex"; then rm -f "$tmp"; echo "The Codex list already matches."; exit 0; fi | ||
| mv "$tmp" "$codex"; chmod 644 "$codex" | ||
| echo "Updated $codex from $claude." |
Uh oh!
There was an error while loading. Please reload this page.
There was a problem hiding this comment.
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${{...}}withgithubcontext data in arun:step could allow an attacker to inject their own code into the runner. This would allow them to steal secrets and code.githubcontext data can have arbitrary user input and should be treated as untrusted. Instead, use an intermediate environment variable withenv:to store the data and use the environment variable in therun: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 🌟