Skip to content
Merged
37 changes: 37 additions & 0 deletions .agents/plugins/marketplace.json
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"
}
]
}
31 changes: 29 additions & 2 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,27 @@
"ref": "v1.0.3",
"sha": "54f5136626954f723919102c2208e17641901e3e"
},
"description": "Help adding Sendbird Chat, UIKit, and Calls to iOS, Android, and JS apps, including authentication and sessions. It runs local shell scripts as hooks. See \"What runs on your machine\" in the README."
"description": "Help adding Sendbird Chat, UIKit, and Calls to iOS, Android, and JS apps, including authentication and sessions. It runs local shell scripts as hooks. See \"What runs on your machine\" in the README.",
"displayName": "Sendbird Client Plugin",
"author": {
"name": "Sendbird",
"url": "https://sendbird.com"
},
"homepage": "https://tools.docs.sendbird.com/",
"repository": "https://github.com/sendbird/sendbird-client-plugin",
"license": "Apache-2.0",
"keywords": [
"sendbird",
"chat",
"uikit",
"calls",
"ios",
"android",
"javascript",
"react",
"react-native"
],
"category": "development"
},
{
"name": "sendbird-cli",
Expand All @@ -25,7 +45,14 @@
"version": "0.5.1",
"registry": "https://registry.npmjs.org"
},
"description": "Set up and operate Sendbird with the CLI; choose client assistance for customer app work."
"description": "Set up and operate Sendbird with the CLI; choose client assistance for customer app work.",
"displayName": "Sendbird CLI",
"author": {
"name": "Sendbird",
"url": "https://sendbird.com"
},
"homepage": "https://tools.docs.sendbird.com/",
"category": "development"
}
]
}
42 changes: 42 additions & 0 deletions .github/workflows/check-marketplaces.yml
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

@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 +32 to +40

@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 +32 to +40

@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 +32 to +40

@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 🌟

- name: Both marketplace files list the same plugins and pins
run: bash scripts/check-marketplaces.sh
144 changes: 135 additions & 9 deletions README.md
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`.
19 changes: 19 additions & 0 deletions scripts/check-marketplaces.sh
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."
24 changes: 24 additions & 0 deletions scripts/sync-codex-marketplace.sh
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."
Loading