From e89deb4a07b20d6307f3e8a01a9ffa8befdd5426 Mon Sep 17 00:00:00 2001 From: johno Date: Sat, 22 Aug 2026 01:42:34 +0000 Subject: [PATCH 1/4] Document additional agent plugin install commands and add a marketplace listing Extends the README with installation commands for Gemini CLI and Kimi CLI (each using their own native extension/MCP mechanisms rather than Agent Plugins), plus GitHub Copilot CLI, VS Code, OpenClaw, Hermes Agent, NanoClaw, and Kiro, all of which implement the Agent Plugins (formerly Open Plugins) standard. Adds .github/plugin/marketplace.json, a marketplace listing for the existing providers/agent-plugins/plugin package, following the same pattern as the existing .claude-plugin, .codex-plugin, .cursor-plugin, and .grok-plugin marketplace files. This lets Agent Plugins-aware marketplace clients (for example GitHub Copilot CLI and VS Code) install directly from this repo without waiting on a separate curated marketplace entry. Committed-By-Agent: goose Orbit-Session-Id: 8a5d6466-1ec5-44b1-a28f-e3dd8987ec17 --- .github/plugin/marketplace.json | 18 ++++++++ README.md | 81 ++++++++++++++++++++++++++++++++- 2 files changed, 98 insertions(+), 1 deletion(-) create mode 100644 .github/plugin/marketplace.json diff --git a/.github/plugin/marketplace.json b/.github/plugin/marketplace.json new file mode 100644 index 00000000..807b7b7d --- /dev/null +++ b/.github/plugin/marketplace.json @@ -0,0 +1,18 @@ +{ + "name": "stripe", + "owner": { + "name": "Stripe", + "email": "support@stripe.com" + }, + "plugins": [ + { + "name": "stripe", + "source": "./providers/agent-plugins/plugin/", + "description": "Stripe agent plugin with skills for Stripe integrations including best practices, API and SDK upgrade guidance, and a remote MCP server configuration.", + "version": "0.1.3", + "author": { + "name": "Stripe" + } + } + ] +} diff --git a/README.md b/README.md index 552aabdb..8a28f7e6 100644 --- a/README.md +++ b/README.md @@ -55,12 +55,91 @@ Run this command in your project: grok plugin install stripe --trust ``` +### Gemini CLI + +Run this command in your project: + +```bash +gemini extensions install https://github.com/stripe/ai +``` + +### Kimi CLI + +Kimi CLI doesn't yet support installable agent plugins, but you can add our +remote MCP server directly: + +```bash +kimi mcp add --transport http stripe https://mcp.stripe.com --auth oauth +``` + ### Agent Plugins -Installation methods currently vary by client for the new [Agent Plugins](https://agent-plugins.org/) standard, but you can point your client to our package via: +The [Agent Plugins](https://agent-plugins.org/) standard (formerly known as +Open Plugins) defines a portable package format for skills and MCP servers, +but leaves distribution and installation up to each client. This repo +publishes a conformant package at +[`providers/agent-plugins/plugin/`](/providers/agent-plugins/plugin) and a +marketplace listing at [`.github/plugin/marketplace.json`](/.github/plugin/marketplace.json) +that clients can use to install it directly from this repo, without waiting +for a curated marketplace listing. + +If your client isn't listed below, you can generally still point it at: - Git URL: `https://github.com/stripe/ai` - Subdirectory: [`providers/agent-plugins/plugin/`](/providers/agent-plugins/plugin). +#### GitHub Copilot CLI + +Run these commands in your project: + +```bash +copilot plugin marketplace add stripe/ai +copilot plugin install stripe@stripe +``` + +#### VS Code + +Add this repo as a plugin marketplace in your `settings.json`, then install +`stripe@stripe` from the Agent Plugins view in the Extensions sidebar: + +```json +"chat.plugins.marketplaces": ["stripe/ai"] +``` + +#### OpenClaw + +Run these commands in your project: + +```bash +openclaw plugins marketplace list stripe/ai +openclaw plugins install stripe --marketplace stripe/ai +``` + +#### Hermes Agent + +Run these commands in your project: + +```bash +hermes plugins install stripe/ai --no-enable +hermes plugins enable stripe +``` + +#### NanoClaw + +NanoClaw only stamps templates from a local directory, so copy the package in +before creating a group: + +```bash +git clone --depth 1 https://github.com/stripe/ai /tmp/stripe-ai +cp -r /tmp/stripe-ai/providers/agent-plugins/plugin templates/stripe +ncl groups create --template stripe --name "Stripe Agent" --yes +``` + +#### Kiro + +Kiro already lists Stripe in its curated registry. Browse to +[kiro.dev/powers](https://kiro.dev/powers), find Stripe, and select +**Add to Kiro** — no manual installation is required. + ## Manual installation From 6bf1e515704795bea95b90305e27a3b0a647bc9b Mon Sep 17 00:00:00 2001 From: johno Date: Sat, 22 Aug 2026 03:15:48 +0000 Subject: [PATCH 2/4] Correct Kimi CLI, Hermes Agent, and OpenClaw install instructions Kimi CLI plugins use their own kimi.plugin.json/.kimi-plugin manifest format, not the Agent Plugins standard, but it does support skills and MCP servers with a compatible shape. Adds .kimi-plugin/plugin.json at the repo root (mirroring the other per-client marketplace directories) so 'kimi plugins install https://github.com/stripe/ai' finds a manifest, and corrects the README section accordingly. Corrects Hermes Agent's install command: its installer accepts an 'owner/repo/' shorthand, so it can point directly at providers/agent-plugins/plugin instead of the (non-existent) repo-root manifest. Also clarifies that portable Agent Plugins packages install disabled regardless, and --no-enable only skips the interactive prompt. Clarifies that OpenClaw's plugin marketplace command reads a repo's .claude-plugin/marketplace.json (or root marketplace.json), which this repo already publishes for Claude Code, rather than the new .github/plugin/marketplace.json added for GitHub Copilot CLI. Committed-By-Agent: goose Orbit-Session-Id: 8a5d6466-1ec5-44b1-a28f-e3dd8987ec17 --- .kimi-plugin/plugin.json | 36 ++++++++++++++++++++++++++++++++++++ README.md | 32 +++++++++++++++++++++----------- 2 files changed, 57 insertions(+), 11 deletions(-) create mode 100644 .kimi-plugin/plugin.json diff --git a/.kimi-plugin/plugin.json b/.kimi-plugin/plugin.json new file mode 100644 index 00000000..974586eb --- /dev/null +++ b/.kimi-plugin/plugin.json @@ -0,0 +1,36 @@ +{ + "name": "stripe", + "version": "0.1.3", + "description": "Stripe agent plugin with skills for Stripe integrations including best practices, API and SDK upgrade guidance, and a remote MCP server configuration.", + "author": { + "name": "Stripe" + }, + "homepage": "https://docs.stripe.com", + "license": "MIT", + "keywords": [ + "stripe", + "payments", + "webhooks", + "api", + "security" + ], + "interface": { + "displayName": "Stripe", + "shortDescription": "Stripe integration skills, upgrade guidance, and a remote MCP server." + }, + "skills": [ + "./providers/agent-plugins/plugin/skills/connect-recommend", + "./providers/agent-plugins/plugin/skills/connect-required-verification-information", + "./providers/agent-plugins/plugin/skills/stripe-apps", + "./providers/agent-plugins/plugin/skills/stripe-best-practices", + "./providers/agent-plugins/plugin/skills/stripe-directory", + "./providers/agent-plugins/plugin/skills/stripe-docs", + "./providers/agent-plugins/plugin/skills/stripe-projects", + "./providers/agent-plugins/plugin/skills/upgrade-stripe" + ], + "mcpServers": { + "stripe": { + "url": "https://mcp.stripe.com" + } + } +} diff --git a/README.md b/README.md index 8a28f7e6..b45455b9 100644 --- a/README.md +++ b/README.md @@ -65,11 +65,13 @@ gemini extensions install https://github.com/stripe/ai ### Kimi CLI -Kimi CLI doesn't yet support installable agent plugins, but you can add our -remote MCP server directly: +Kimi CLI plugins use their own manifest format rather than the Agent Plugins +standard, so this repo also publishes a [`.kimi-plugin/plugin.json`](/.kimi-plugin/plugin.json) +manifest at its root that points at our existing skills and MCP server. Run +this command in your project: -```bash -kimi mcp add --transport http stripe https://mcp.stripe.com --auth oauth +```text +/plugins install https://github.com/stripe/ai ``` ### Agent Plugins @@ -78,10 +80,11 @@ The [Agent Plugins](https://agent-plugins.org/) standard (formerly known as Open Plugins) defines a portable package format for skills and MCP servers, but leaves distribution and installation up to each client. This repo publishes a conformant package at -[`providers/agent-plugins/plugin/`](/providers/agent-plugins/plugin) and a -marketplace listing at [`.github/plugin/marketplace.json`](/.github/plugin/marketplace.json) -that clients can use to install it directly from this repo, without waiting -for a curated marketplace listing. +[`providers/agent-plugins/plugin/`](/providers/agent-plugins/plugin) plus a +[`.github/plugin/marketplace.json`](/.github/plugin/marketplace.json) listing +that clients checking that path (for example GitHub Copilot CLI) can use to +install it directly from this repo, without waiting for a curated marketplace +listing. If your client isn't listed below, you can generally still point it at: - Git URL: `https://github.com/stripe/ai` @@ -107,7 +110,9 @@ Add this repo as a plugin marketplace in your `settings.json`, then install #### OpenClaw -Run these commands in your project: +OpenClaw resolves marketplaces from a repo's `.claude-plugin/marketplace.json`, +which this repo already publishes for Claude Code. Run these commands in your +project: ```bash openclaw plugins marketplace list stripe/ai @@ -116,10 +121,15 @@ openclaw plugins install stripe --marketplace stripe/ai #### Hermes Agent -Run these commands in your project: +Hermes's installer accepts an `owner/repo/` shorthand, so you can +point it directly at the package subdirectory. Portable Agent Plugins packages +always install disabled — `--no-enable` just skips the interactive prompt so +the command is non-interactive — so you'll need to enable it explicitly after +reviewing it: ```bash -hermes plugins install stripe/ai --no-enable +hermes plugins install stripe/ai/providers/agent-plugins/plugin --no-enable +hermes plugins list hermes plugins enable stripe ``` From 1f3b74a5a62f0216ef931676beb53b7c4c145201 Mon Sep 17 00:00:00 2001 From: johno Date: Sat, 22 Aug 2026 04:12:06 +0000 Subject: [PATCH 3/4] Cite sources for each agent plugin install instruction Adds a source link/citation after each install command so reviewers can verify commands without installing the corresponding client, and adds a short comparison of marketplace.json schemas across clients that check for a root-level file (Claude Code, Codex, GitHub Copilot CLI), since they are not all identical. Committed-By-Agent: goose Orbit-Session-Id: 8a5d6466-1ec5-44b1-a28f-e3dd8987ec17 --- README.md | 61 ++++++++++++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 58 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index b45455b9..141c1a76 100644 --- a/README.md +++ b/README.md @@ -63,6 +63,8 @@ Run this command in your project: gemini extensions install https://github.com/stripe/ai ``` +Source: [Gemini CLI extensions docs](https://github.com/google-gemini/gemini-cli/blob/main/docs/extensions/index.md). + ### Kimi CLI Kimi CLI plugins use their own manifest format rather than the Agent Plugins @@ -74,6 +76,12 @@ this command in your project: /plugins install https://github.com/stripe/ai ``` +Sources: [Kimi Code CLI plugin docs](https://www.kimi.com/code/docs/en/kimi-code-cli/customization/plugins) +([mirror source](https://github.com/MoonshotAI/kimi-code/blob/main/docs/en/customization/plugins.md)), +and Kimi's own [`marketplace.json` example](https://github.com/MoonshotAI/kimi-code/blob/main/plugins/marketplace.json), +which confirms Kimi's manifest fields (`plugins[].id`, `source`, `displayName`) +rather than the Agent Plugins `plugin.json` shape used elsewhere in this repo. + ### Agent Plugins The [Agent Plugins](https://agent-plugins.org/) standard (formerly known as @@ -90,6 +98,35 @@ If your client isn't listed below, you can generally still point it at: - Git URL: `https://github.com/stripe/ai` - Subdirectory: [`providers/agent-plugins/plugin/`](/providers/agent-plugins/plugin). +The clients below are drawn from the Agent Plugins spec's own +[compatible clients list](https://agent-plugins.org/compatible-clients) +([source](https://github.com/agentplugins/agent-plugins-site/blob/main/lib/compatible-clients.ts)). + +A few of these clients look for a bare, root-level `marketplace.json` (or a +`.claude-plugin/marketplace.json`/`.cursor-plugin/marketplace.json` fallback), +but they don't all parse the same schema. For example: +- Claude Code's format requires a top-level `owner` object and per-plugin + `description`/`version`/`author` fields — see the + [Claude Code marketplace docs](https://docs.claude.com/en/docs/claude-code/plugin-marketplaces). +- Codex checks four candidate paths (`.agents/plugins/marketplace.json`, + `.agents/plugins/api_marketplace.json`, `.claude-plugin/marketplace.json`, + and `.cursor-plugin/marketplace.json` — notably *not* `.codex-plugin/marketplace.json`) + and additionally expects a Codex-specific `policy.installation`/ + `policy.authentication` object and optional `category` per plugin, per the + `RawMarketplaceManifest`/`RawMarketplaceManifestPlugin` types in + [`codex-rs/core-plugins/src/marketplace.rs`](https://github.com/openai/codex/blob/main/codex-rs/core-plugins/src/marketplace.rs). +- GitHub Copilot CLI checks `.github/plugin/marketplace.json` first, then + falls back to `.claude-plugin/marketplace.json`, and documents itself as + compatible with the Claude Code schema plus optional "Open Plugin Spec" + extensions — see the + [Copilot CLI plugin reference](https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-plugin-reference). + +In short: several clients converge on (or fall back to) the schema Claude +Code originated, but Codex's variant adds required fields Claude's doesn't +have, and Cursor and Kimi use their own dedicated formats — so a listing +built for one client isn't guaranteed to validate on another without checking +that client's own docs or source first. + #### GitHub Copilot CLI Run these commands in your project: @@ -99,6 +136,8 @@ copilot plugin marketplace add stripe/ai copilot plugin install stripe@stripe ``` +Source: [Copilot CLI plugin reference](https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-plugin-reference). + #### VS Code Add this repo as a plugin marketplace in your `settings.json`, then install @@ -108,17 +147,23 @@ Add this repo as a plugin marketplace in your `settings.json`, then install "chat.plugins.marketplaces": ["stripe/ai"] ``` +Source: [VS Code Agent Plugins docs](https://code.visualstudio.com/docs/agent-customization/agent-plugins). + #### OpenClaw -OpenClaw resolves marketplaces from a repo's `.claude-plugin/marketplace.json`, -which this repo already publishes for Claude Code. Run these commands in your -project: +OpenClaw resolves marketplaces from a repo's `.claude-plugin/marketplace.json` +first, falling back to a bare root `marketplace.json` — this repo already +publishes the former for Claude Code. Run these commands in your project: ```bash openclaw plugins marketplace list stripe/ai openclaw plugins install stripe --marketplace stripe/ai ``` +Sources: [OpenClaw plugin bundles docs](https://docs.openclaw.ai/plugins/bundles) +and the `MARKETPLACE_MANIFEST_CANDIDATES` constant in +[`src/plugins/marketplace.ts`](https://github.com/openclaw/openclaw/blob/main/src/plugins/marketplace.ts). + #### Hermes Agent Hermes's installer accepts an `owner/repo/` shorthand, so you can @@ -133,6 +178,12 @@ hermes plugins list hermes plugins enable stripe ``` +Sources: [Hermes Agent plugin docs](https://hermes-agent.nousresearch.com/docs/developer-guide/plugins#portable-agent-plugins-v1-packages), +and the subdirectory-shorthand parsing in +[`hermes_cli/plugin_packs.py`](https://github.com/NousResearch/hermes-agent/blob/main/hermes_cli/plugin_packs.py) +and the `--enable`/`--no-enable` prompt-skip flags in +[`hermes_cli/subcommands/plugins.py`](https://github.com/NousResearch/hermes-agent/blob/main/hermes_cli/subcommands/plugins.py). + #### NanoClaw NanoClaw only stamps templates from a local directory, so copy the package in @@ -144,12 +195,16 @@ cp -r /tmp/stripe-ai/providers/agent-plugins/plugin templates/stripe ncl groups create --template stripe --name "Stripe Agent" --yes ``` +Source: [NanoClaw templates docs](https://github.com/nanocoai/nanoclaw/blob/main/docs/templates.md). + #### Kiro Kiro already lists Stripe in its curated registry. Browse to [kiro.dev/powers](https://kiro.dev/powers), find Stripe, and select **Add to Kiro** — no manual installation is required. +Source: [Kiro powers docs](https://kiro.dev/docs/powers/). + ## Manual installation From e6ebfa692079864118ac0d8ce5f6a9f597891fe7 Mon Sep 17 00:00:00 2001 From: johno Date: Sat, 22 Aug 2026 04:22:10 +0000 Subject: [PATCH 4/4] Move install-source research out of README into PR description The README should stay evergreen and only list the commands users need to run. The per-client source citations and marketplace.json schema comparison were moved to the pull request description instead. Committed-By-Agent: goose Orbit-Session-Id: 8a5d6466-1ec5-44b1-a28f-e3dd8987ec17 --- README.md | 55 ------------------------------------------------------- 1 file changed, 55 deletions(-) diff --git a/README.md b/README.md index 141c1a76..0378fcdc 100644 --- a/README.md +++ b/README.md @@ -63,8 +63,6 @@ Run this command in your project: gemini extensions install https://github.com/stripe/ai ``` -Source: [Gemini CLI extensions docs](https://github.com/google-gemini/gemini-cli/blob/main/docs/extensions/index.md). - ### Kimi CLI Kimi CLI plugins use their own manifest format rather than the Agent Plugins @@ -76,12 +74,6 @@ this command in your project: /plugins install https://github.com/stripe/ai ``` -Sources: [Kimi Code CLI plugin docs](https://www.kimi.com/code/docs/en/kimi-code-cli/customization/plugins) -([mirror source](https://github.com/MoonshotAI/kimi-code/blob/main/docs/en/customization/plugins.md)), -and Kimi's own [`marketplace.json` example](https://github.com/MoonshotAI/kimi-code/blob/main/plugins/marketplace.json), -which confirms Kimi's manifest fields (`plugins[].id`, `source`, `displayName`) -rather than the Agent Plugins `plugin.json` shape used elsewhere in this repo. - ### Agent Plugins The [Agent Plugins](https://agent-plugins.org/) standard (formerly known as @@ -98,35 +90,6 @@ If your client isn't listed below, you can generally still point it at: - Git URL: `https://github.com/stripe/ai` - Subdirectory: [`providers/agent-plugins/plugin/`](/providers/agent-plugins/plugin). -The clients below are drawn from the Agent Plugins spec's own -[compatible clients list](https://agent-plugins.org/compatible-clients) -([source](https://github.com/agentplugins/agent-plugins-site/blob/main/lib/compatible-clients.ts)). - -A few of these clients look for a bare, root-level `marketplace.json` (or a -`.claude-plugin/marketplace.json`/`.cursor-plugin/marketplace.json` fallback), -but they don't all parse the same schema. For example: -- Claude Code's format requires a top-level `owner` object and per-plugin - `description`/`version`/`author` fields — see the - [Claude Code marketplace docs](https://docs.claude.com/en/docs/claude-code/plugin-marketplaces). -- Codex checks four candidate paths (`.agents/plugins/marketplace.json`, - `.agents/plugins/api_marketplace.json`, `.claude-plugin/marketplace.json`, - and `.cursor-plugin/marketplace.json` — notably *not* `.codex-plugin/marketplace.json`) - and additionally expects a Codex-specific `policy.installation`/ - `policy.authentication` object and optional `category` per plugin, per the - `RawMarketplaceManifest`/`RawMarketplaceManifestPlugin` types in - [`codex-rs/core-plugins/src/marketplace.rs`](https://github.com/openai/codex/blob/main/codex-rs/core-plugins/src/marketplace.rs). -- GitHub Copilot CLI checks `.github/plugin/marketplace.json` first, then - falls back to `.claude-plugin/marketplace.json`, and documents itself as - compatible with the Claude Code schema plus optional "Open Plugin Spec" - extensions — see the - [Copilot CLI plugin reference](https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-plugin-reference). - -In short: several clients converge on (or fall back to) the schema Claude -Code originated, but Codex's variant adds required fields Claude's doesn't -have, and Cursor and Kimi use their own dedicated formats — so a listing -built for one client isn't guaranteed to validate on another without checking -that client's own docs or source first. - #### GitHub Copilot CLI Run these commands in your project: @@ -136,8 +99,6 @@ copilot plugin marketplace add stripe/ai copilot plugin install stripe@stripe ``` -Source: [Copilot CLI plugin reference](https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-plugin-reference). - #### VS Code Add this repo as a plugin marketplace in your `settings.json`, then install @@ -147,8 +108,6 @@ Add this repo as a plugin marketplace in your `settings.json`, then install "chat.plugins.marketplaces": ["stripe/ai"] ``` -Source: [VS Code Agent Plugins docs](https://code.visualstudio.com/docs/agent-customization/agent-plugins). - #### OpenClaw OpenClaw resolves marketplaces from a repo's `.claude-plugin/marketplace.json` @@ -160,10 +119,6 @@ openclaw plugins marketplace list stripe/ai openclaw plugins install stripe --marketplace stripe/ai ``` -Sources: [OpenClaw plugin bundles docs](https://docs.openclaw.ai/plugins/bundles) -and the `MARKETPLACE_MANIFEST_CANDIDATES` constant in -[`src/plugins/marketplace.ts`](https://github.com/openclaw/openclaw/blob/main/src/plugins/marketplace.ts). - #### Hermes Agent Hermes's installer accepts an `owner/repo/` shorthand, so you can @@ -178,12 +133,6 @@ hermes plugins list hermes plugins enable stripe ``` -Sources: [Hermes Agent plugin docs](https://hermes-agent.nousresearch.com/docs/developer-guide/plugins#portable-agent-plugins-v1-packages), -and the subdirectory-shorthand parsing in -[`hermes_cli/plugin_packs.py`](https://github.com/NousResearch/hermes-agent/blob/main/hermes_cli/plugin_packs.py) -and the `--enable`/`--no-enable` prompt-skip flags in -[`hermes_cli/subcommands/plugins.py`](https://github.com/NousResearch/hermes-agent/blob/main/hermes_cli/subcommands/plugins.py). - #### NanoClaw NanoClaw only stamps templates from a local directory, so copy the package in @@ -195,16 +144,12 @@ cp -r /tmp/stripe-ai/providers/agent-plugins/plugin templates/stripe ncl groups create --template stripe --name "Stripe Agent" --yes ``` -Source: [NanoClaw templates docs](https://github.com/nanocoai/nanoclaw/blob/main/docs/templates.md). - #### Kiro Kiro already lists Stripe in its curated registry. Browse to [kiro.dev/powers](https://kiro.dev/powers), find Stripe, and select **Add to Kiro** — no manual installation is required. -Source: [Kiro powers docs](https://kiro.dev/docs/powers/). - ## Manual installation