Document Agent Plugins install instructions for more clients - #496
Open
johno-stripe wants to merge 4 commits into
Open
Document Agent Plugins install instructions for more clients#496johno-stripe wants to merge 4 commits into
johno-stripe wants to merge 4 commits into
Conversation
…ce 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
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/<subdirectory>' 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
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
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
mc806888-png
approved these changes
Aug 22, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Extends the plugin installation docs in
README.mdto cover additionalclients that support (or claim to support) the Agent Plugins
standard, plus adds two new manifest/listing files so those clients can pick
up this repo's package directly:
.github/plugin/marketplace.json— a marketplace listing at the pathGitHub Copilot CLI (and VS Code) check for, pointing at
providers/agent-plugins/plugin/..kimi-plugin/plugin.json— Kimi Code CLI's own plugin manifest format(distinct from the Agent Plugins
plugin.jsonshape), pointing at thesame skills and MCP server.
Claude Code, Cursor, Codex, and Grok already had working, dedicated
marketplace files before this change and are untouched here.
Sources for each install command
So reviewers can verify these commands without installing every client:
(mirror),
example marketplace.json
marketplace.jsoncandidate paths in sourcesubdirectory shorthand in source,
--enable/--no-enableflags in sourcecompatible clients registry
(source)
Do all "root marketplace.json" clients share one format?
No — several clients look for a marketplace listing at a root-ish path, but
the schemas diverge:
ownerobject and per-plugindescription/version/authorfields(docs).
.agents/plugins/marketplace.json,.agents/plugins/api_marketplace.json,.claude-plugin/marketplace.json,.cursor-plugin/marketplace.json— notably not.codex-plugin/marketplace.json)and requires a Codex-specific
policy.installation/policy.authenticationobject per plugin, per the
RawMarketplaceManifesttypes inmarketplace.rs..github/plugin/marketplace.jsonfirst, thenfalls back to
.claude-plugin/marketplace.json, and documents itself ascompatible with Claude's schema plus optional "Open Plugin Spec" extensions
(docs).
.claude-plugin/marketplace.jsonfirst, then fallsback to a bare root
marketplace.json(source).
shared fallback.
Net: 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,
so a listing built for one client isn't guaranteed to validate on another.
This is also called out inline in
README.md.