Aller au contenu
Documentation : Marketplaces de plugins

Marketplaces de plugins

Installer les éléments publiés sous forme de plugins : dans Claude Code depuis ce site, dans Codex et Cursor depuis un miroir git.

La documentation fournie avec Ronne AI Marketplace 0.3.0, traduite de l'anglais.

Ce que c'est

Ce marketplace propose ses éléments publiés à Claude Code sous forme de marketplace de plugins. Une fois qu'il est ajouté, vous parcourez et installez les éléments depuis /plugin dans Claude Code comme n'importe quel autre plugin, sans rmk install.

  • Rien ne change à la publication : seules les versions publiées sont proposées, après la revue, et chaque élément à la version que liste le catalogue (celle de latest).
  • Chaque plugin est l'élément avec les dépendances avec lesquelles il s'installerait, résolues quand le plugin est généré pour la première fois; un lot est un plugin avec ses membres. Son nom est celui de l'élément, avec un point : @team/secure-coding devient team.secure-coding.
  • Une version dépréciée l'indique au début de sa description. Une version retirée disparaît du marketplace la prochaine fois que Claude Code l'actualise.
  • Les éléments qui n'ont pas leur place dans un plugin ne sont pas proposés : les lignes d'état, les politiques de permissions et les règles toujours actives ou qui suivent des motifs de fichiers. Installez-les avec rmk.
  • Chaque téléchargement de plugin compte comme une installation de l'élément, comme un téléchargement par rmk.

Claude Code est le seul outil qui peut lire un marketplace directement depuis ce site. Codex et Cursor n'ajoutent des marketplaces qu'à partir de dépôts git; ils en lisent donc un miroir git.

Claude Code

  1. Connectez-vous avec rmk login, si ce n'est pas déjà fait : Installer avec rmk.
  2. Ajoutez le marketplace à Claude Code :
rmk plugin-setup claude-code                    # for you, in ~/.claude/settings.json
rmk plugin-setup claude-code --scope project    # for a project, in .claude/settings.json
rmk plugin-setup claude-code --remove

La commande ajoute le marketplace ronne-ronne-example, que Claude Code lit à partir de :

https://ronne.example/api/v1/feeds/claude-code/marketplace.json

Avec --scope project, versionnez .claude/settings.json pour le partager : Claude Code lit les marketplaces d'un projet une fois que vous faites confiance au dossier, et chaque personne se connecte quand même avec rmk.

Ensuite, installez : lancez /plugin dans Claude Code et choisissez des éléments du marketplace, ou installez-en un par son nom :

/plugin install team.secure-coding@ronne-ronne-example

La page d'un élément affiche cette commande dans son panneau Install quand il peut être installé comme plugin. Les skills et les commandes d'un plugin s'exécutent précédés de son nom, comme /team.secure-coding:secure-coding.

Claude Code récupère le marketplace de nouveau quand vous lancez /plugin marketplace update, ou de lui-même une fois que vous activez sa mise à jour automatique sous Marketplaces dans /plugin. Une nouvelle publication apparaît alors comme une mise à jour.

Il faut Claude Code 2.1.238 ou plus récent, et ce site à une adresse https:// : Claude Code ne télécharge pas de plugins par http:// ni depuis localhost.

Jetons

Le marketplace exige un jeton, comme le reste de l'API. Claude Code obtient le vôtre en lançant rmk auth headers, que rmk plugin-setup inscrit dans les réglages comme headersHelper du marketplace. Cette commande affiche le jeton que rmk login a enregistré (ou RMK_TOKEN), et Claude Code l'envoie quand il lit le marketplace et y télécharge des plugins.

  • Claude Code la lance depuis ~/.claude, sans la configuration de votre shell, donc un Node.js installé avec nvm n'est pas dans son PATH. Dans vos propres réglages, rmk plugin-setup inscrit par leurs chemins complets le Node.js et le rmk avec lesquels vous l'avez lancé : relancez-le après avoir changé ou mis à jour Node.js.
  • Les réglages d'un projet inscrivent simplement rmk, puisqu'ils sont partagés : là, rmk et Node.js doivent être dans le PATH avec lequel Claude Code démarre. --command indique une autre commande, comme --command /opt/homebrew/bin/rmk.
  • Quand le jeton expire ou est révoqué, le marketplace cesse de s'actualiser, et Claude Code indique qu'il ne se charge pas. Les plugins que vous avez installés continuent de fonctionner. Relancez rmk login pour régler le problème.
  • Pour les réglages d'un projet, Claude Code cache à la commande les variables qui ressemblent à des secrets, donc RMK_TOKEN n'y est pas visible : utilisez rmk login.
  • Pour une version plus ancienne de Claude Code, --static-headers écrit le jeton lui-même dans vos réglages d'utilisateur (jamais dans ceux d'un projet, qui vont habituellement dans git). Relancez la commande après vous être reconnecté.

Codex et Cursor (miroir git)

Codex et Cursor n'ajoutent des marketplaces de plugins qu'à partir de dépôts git. rmk écrit donc les plugins de ce marketplace sous forme de dépôt, un miroir, que vous poussez vers votre hébergeur git, et les outils ajoutent ce dépôt.

git clone [email protected]:your-org/ronne-plugins.git && cd ronne-plugins
rmk feed build --out .
git add --all && git commit -m 'Update the plugin feed' && git push
  • Il écrit le fichier de marketplace de chaque outil (.agents/plugins/marketplace.json pour Codex, .cursor-plugin/marketplace.json pour Cursor, .claude-plugin/marketplace.json pour Claude Code), chaque plugin sous plugins/<tool>/, et .rmk-feed.json, la liste de ce qu'il a écrit.
  • Le miroir contient les mêmes plugins que le marketplace de Claude Code, chacun dans la structure de son outil : les plugins Codex ne contiennent pas d'agents, et seuls ceux de Cursor contiennent des règles toujours actives ou qui suivent des motifs de fichiers.
  • Quiconque peut lire le dépôt peut installer tous ses plugins. Gardez-le privé, et laissez votre hébergeur git décider qui peut le lire.

Ajoutez-le ensuite dans chaque outil :

  • Codex : codex plugin marketplace add your-org/ronne-plugins (ou l'URL git du dépôt), puis installez-en des plugins. codex plugin marketplace upgrade le récupère de nouveau. Codex le clone avec git; pour un dépôt privé, git doit donc pouvoir le cloner sur cette machine.
  • Cursor : un administrateur d'équipe (forfait Teams ou Enterprise) l'importe dans le tableau de bord, sous Settings › Plugins › Team Marketplaces › Import, depuis GitHub, GitLab, Bitbucket ou Azure DevOps, et choisit qui le voit. Pour une importation depuis GitHub, Enable Auto Refresh intègre chaque modification poussée.
  • Claude Code peut aussi l'ajouter, avec /plugin marketplace add your-org/ronne-plugins : pour les personnes qui peuvent lire le dépôt mais n'ont pas de compte ici.

Garder le miroir à jour

Une nouvelle publication arrive dans le miroir la prochaine fois que rmk feed build s'exécute. Confiez-le à la CI :

rmk feed build --print-workflow github > .github/workflows/ronne-plugin-feed.yml
rmk feed build --print-workflow gitlab > .gitlab-ci.yml
  • Le workflow GitHub s'exécute chaque jour et quand vous le lancez, installe la même version de rmk que celle qui l'a affiché, génère le miroir, puis crée un commit et le pousse seulement si quelque chose a changé. Les commentaires en tête du fichier indiquent quoi définir : les secrets RMK_REGISTRY et RMK_TOKEN.
  • La tâche GitLab fait de même; vous ajoutez sa planification quotidienne sous Build › Pipeline schedules, et elle a aussi besoin de RMK_PUSH_TOKEN, un jeton d'accès de projet qui peut pousser.
  • Créez RMK_TOKEN sur un compte destiné au miroir : la génération lit ce que ce compte peut lire. Quand le jeton expire ou est révoqué, la génération échoue et le miroir reste tel quel, donc les outils gardent leurs plugins; créez un nouveau jeton et mettez à jour le secret.
  • Une exécution sans nouvelle publication ne change rien, donc il n'y a pas de commit. Une nouvelle publication remplace le dossier de ce plugin en entier; le dossier d'une version retirée est supprimé.
  • rmk n'écrit que les chemins qu'il consigne : un README ou le fichier de CI restent tels que vous les avez écrits. Si quelque chose sous plugins/ ne lui appartient pas, ou a changé depuis qu'il l'a écrit, la génération s'arrête et le liste (--force écrase ses propres chemins). --tools codex,cursor ne génère le miroir que pour certains outils.

Grands marketplaces

Claude Code ne lit un marketplace à partir d'une adresse que s'il fait au plus 5 Mio et arrive en 10 secondes ou moins. Chaque élément occupe environ un demi-kilooctet, donc le marketplace Claude Code de ce site atteint 5 Mio vers 10 000 éléments.

  • Le marketplace est généré une fois, puis servi depuis la mémoire jusqu'à ce que quelque chose soit publié, étiqueté, déprécié ou retiré. La première requête après un changement le génère de nouveau.
  • Chaque plugin est généré la première fois que quelqu'un le demande. Quand une requête manque de temps, elle liste ce qui est généré, et le reste est généré juste après, donc la prochaine actualisation liste tout.
  • Root voit la dernière génération de chaque outil sous Admin › Settings › Plugin feeds : sa taille, ses plugins et sa durée de génération, avec un avertissement dès que le marketplace de Claude Code dépasse 4 Mio ou qu'une génération prend 5 secondes.
  • Au-delà de 5 Mio, le marketplace de Claude Code répond plutôt par une erreur. Ajoutez alors le miroir git dans Claude Code : un marketplace dans un dépôt git n'a pas cette limite. Ceux de Codex et de Cursor n'ont pas de limite ici, puisque seul rmk feed build les lit.

Plugins ou rmk

  • Les plugins s'installent depuis Claude Code, pour vous, et Claude Code les garde dans son propre dossier. Ils conviennent pour essayer des éléments, et aux personnes qui n'utilisent que Claude Code.
  • rmk install fonctionne pour tous les outils, écrit les fichiers dans le projet et fixe les versions dans rmk.lock pour que vos coéquipiers obtiennent les mêmes. L'utilisation n'est signalée que pour les éléments que rmk a installés.

Installez un élément d'une seule façon, pas des deux : Claude Code le chargerait deux fois. Quand rmk install écrit pour Claude Code un élément qui est aussi activé comme plugin de ce marketplace, il avertit, et l'installe quand même. Désinstallez le plugin dans /plugin, ou lancez rmk remove.