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-codingdevientteam.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
- Connectez-vous avec
rmk login, si ce n'est pas déjà fait : Installer avec rmk. - 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 sonPATH. Dans vos propres réglages,rmk plugin-setupinscrit par leurs chemins complets le Node.js et lermkavec 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à,rmket Node.js doivent être dans lePATHavec lequel Claude Code démarre.--commandindique 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 loginpour 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_TOKENn'y est pas visible : utilisezrmk 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.jsonpour Codex,.cursor-plugin/marketplace.jsonpour Cursor,.claude-plugin/marketplace.jsonpour Claude Code), chaque plugin sousplugins/<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 upgradele 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
rmkque 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 secretsRMK_REGISTRYetRMK_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_TOKENsur 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é.
rmkn'écrit que les chemins qu'il consigne : un README ou le fichier de CI restent tels que vous les avez écrits. Si quelque chose sousplugins/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,cursorne 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 buildles 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 installfonctionne pour tous les outils, écrit les fichiers dans le projet et fixe les versions dansrmk.lockpour que vos coéquipiers obtiennent les mêmes. L'utilisation n'est signalée que pour les éléments quermka 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.