Skip to content

Utiliser des plugins / Créer des plugins

Installez des plugins disponibles ou préparez un paquet portable Agent Plugins 1.0.

Utiliser des plugins

Disponible maintenant : installez des plugins avec Universal Agent Plugins. Avec Node.js 22+, exécutez :

bash
npx universal-agent-plugins add context7

Pour une installation native sur macOS, Linux ou Windows, consultez le guide. Le CLI demande quels agents compatibles utiliser ; chaque plugin peut nécessiter son propre environnement d’exécution.

Guide d’installation

Versions vérifiées le 2026-09-07 : universal-agent-plugins 0.1.53 (npm), plugin-kit-ai 1.2.4 (npm/PyPI), version stable GitHub agentplugins-v0.1.53.

La compatibilité dépend du paquet. La validation du schéma ne prouve ni l’exécution, ni OAuth, ni l’activation. Codex ne prend pas en charge MCP SSE déclaré ; stdio et Streamable HTTP conservent leur prise en charge par les adaptateurs existants.

Compatibilité des clients (en anglais)

Créer des plugins

Créez un paquet portable Agent Plugins 1.0 autour de plugin.json, avec skills/ et mcp.json facultatifs. La prise en charge dépend du paquet et de ses composants.

En préparation — non publié

Le CLI de création fondé sur le standard est en préparation et n’est pas encore publié. plugin-kit-ai 1.2.4, publié sur npm et PyPI, est l’outil historique v1, pas standard-first v2. Installer plugin-kit-ai@latest ne fournit pas le futur parcours de création.

Spécification Agent Plugins 1.0

Maintenance historique v1

Maintenez les projets plugin.yaml existants avec les instructions v1 ci-dessous. Ces modèles et sorties générées relèvent des parcours historiques v1 ; ils ne créent pas le nouveau parcours fondé sur le standard.

bash
brew install 777genius/homebrew-plugin-kit-ai/plugin-kit-ai
plugin-kit-ai version
plugin-kit-ai init my-plugin
cd my-plugin
go mod tidy
plugin-kit-ai generate .
plugin-kit-ai validate . --platform codex-runtime --strict

Ce que vous obtenez

  • un dépôt de plugin dès le premier jour
  • fichiers créés sous plugin/
  • généré une sortie d'exécution Codex à partir du même dépôt
  • un contrôle de préparation propre via validate --strict

Chemins Node et Python pris en charge

Si votre équipe habite déjà à Node/TypeScript ou Python, ces chemins sont pris en charge et visibles dès le départ :

  • codex-runtime --runtime node --typescript
  • codex-runtime --runtime python
  • les deux sont des chemins d'exécution interprétés localement, donc la machine cible a toujours besoin de Node.js 20+ ou Python 3.10+
  • Go reste toujours la valeur par défaut lorsque vous souhaitez l'histoire de production générale la plus forte

Si vous commencez intentionnellement le Node ou Python

Utilisez ce flux alternatif uniquement lorsque le choix de la langue fait déjà partie des exigences du produit :

bash
plugin-kit-ai init my-plugin --platform codex-runtime --runtime node --typescript
plugin-kit-ai doctor ./my-plugin
plugin-kit-ai bootstrap ./my-plugin
plugin-kit-ai generate ./my-plugin
plugin-kit-ai validate ./my-plugin --platform codex-runtime --strict

Ou commencez par Python :

bash
plugin-kit-ai init my-plugin --platform codex-runtime --runtime python
plugin-kit-ai doctor ./my-plugin
plugin-kit-ai bootstrap ./my-plugin
plugin-kit-ai generate ./my-plugin
plugin-kit-ai validate ./my-plugin --platform codex-runtime --strict

Que faire ensuite

  • modifiez le plugin sous plugin/
  • exécutez à nouveau plugin-kit-ai generate ./my-plugin après les modifications
  • exécutez à nouveau plugin-kit-ai validate ./my-plugin --platform codex-runtime --strict
  • ensuite seulement, ajoutez un autre moyen de l'expédier si le produit en a besoin

Développer plus tard

Si tu veuxAjoutez ceci plus tard
Claude crochets comme produit réelclaude
Forfait officiel Codexcodex-package
Gemini package d'extensiongemini
Configuration de l'intégration appartenant au dépôtopencode ou cursor

Choisissez d'abord claude uniquement lorsque les crochets Claude constituent déjà la véritable exigence du produit.

Ce qui se développera plus tard

  • le dépôt reste unifié à mesure que vous ajoutez plus de voies
  • les voies de package et d'extension proviennent de la même source d'auteur
  • OpenCode et Cursor conviennent lorsque le dépôt doit posséder la configuration d'intégration
  • la limite exacte du support reste dans les documents de référence, pas dans votre flux de premier démarrage

Après le démarrage rapide

Documentation publique pour les auteurs de plugins et les intégrateurs.