Plugin

Un plugin est un dépôt Git capable de partager d’un coup un ensemble de composants.

Les plugins sont généralement regroupés au sein de marketplaces pour être installés par les agent runtimes, mais ils peuvent aussi être installés directement via l’Agent Package Manager ou certains agent runtimes (comme goose).

Structure

Un plugin est généralement identifié par un fichier plugin.json (peut varier selon l’agent runtime). Son emplacement et son contenu (avec de légères variations) dépendent du (ou des) agent runtime(s) cible(s).

Format : Agent Plugins
Lu par : Copilot, Cursor, Devin, Hermes
Variables d’environnement :
- PLUGIN_ROOT (répertoire du plugin)
- PLUGIN_DATA (répertoire de données du plugin)

repository/
├── plugin.json
├── skills/
│   └── skill-name/
│       └── SKILL.md
├── mcp.json
└── com.example.client/

Le répertoire com.example.client est une extension client. Il contient des composants dans un format spécifique à l’agent runtime (hooks, serveurs MCP, skills, etc.).

Copilot : com.github.copilot/

Format : Claude Code
Aussi lu par : Codex (partiellement), Copilot (partiellement), Devin (partiellement)
Variables d’environnement :
- CLAUDE_PLUGIN_ROOT (répertoire du plugin)
- CLAUDE_PLUGIN_DATA (répertoire de données du plugin)
- CLAUDE_PROJECT_DIR (répertoire de l’espace de travail)
- CLAUDE_PLUGIN_OPTION_<KEY> (valeurs userConfig, compatible uniquement avec Claude Code)

repository/
├── .claude-plugin/
│   └── plugin.json
├── agents/
│   └── reviewer.md
├── commands/
│   └── special.md
├── hooks/
│   └── hooks.json
├── monitors/
│   └── monitors.json
├── skills/
│   └── skill-name/
│       └── SKILL.md
├── .mcp.json
└── .lsp.json

Format : Codex
Variables d’environnement :
- PLUGIN_ROOT (répertoire racine du plugin)
- PLUGIN_DATA (répertoire de données du plugin)
- CLAUDE_PLUGIN_ROOT / CLAUDE_PLUGIN_DATA (alias conservés pour compatibilité)

repository/
├── .codex-plugin/
│   └── plugin.json
├── skills/
│   └── skill-name/
│       └── SKILL.md
├── hooks/
│   └── hooks.json
├── .mcp.json
└── .app.json

Format : Copilot
Variables d’environnement :
- PLUGIN_ROOT (répertoire du plugin)
- COPILOT_PLUGIN_DATA (répertoire de données du plugin, aliasé en CLAUDE_PLUGIN_DATA)

repository/
├── plugin.json
├── agents/
│   └── reviewer.agent.md
├── skills/
│   └── skill-name/
│       └── SKILL.md
├── hooks.json
└── .mcp.json

Format : Cursor

repository/
├── .cursor-plugin/
│   └── plugin.json
├── rules/
│   └── rule-name.mdc
├── skills/
│   └── skill-name/
│       └── SKILL.md
├── hooks/
│   └── hooks.json
└── mcp.json

Format : Antigravity

repository/
├── plugin.json
├── mcp_config.json
├── hooks.json
├── skills/
│   └── skill-name/
│       └── SKILL.md
├── agents/
│   └── reviewer.md
└── rules/
    └── rule-name.md

Format : Devin
Variables d’environnement :
- PLUGIN_ROOT (répertoire du plugin)
- PLUGIN_DATA (répertoire de données du plugin)
- DEVIN_PROJECT_DIR (répertoire de l’espace de travail)

repository/
├── .devin-plugin/
│   └── plugin.json
├── AGENTS.md
├── rules/
│   └── rule-name.md
├── agents/
│   └── reviewer.md
├── hooks.json
├── .mcp.json
└── skills/
    └── skill-name/
        └── SKILL.md

Format : Hermes Agent

repository/
├── plugin.yaml
├── __init__.py
└── skills/
    └── skill-name/
        └── SKILL.md

# __init__.py
def register(ctx):
    ctx.register_hook("pre_tool_call", my_pre_tool_call)
    ctx.register_tool("my_tool", my_tool_handler)
    ctx.register_skill("my-skill", "skills/my-skill/SKILL.md")
    ctx.register_command("my-command", my_command_handler)
    # `register_cli_command`, `register_platform`, `register_memory_provider`
    # `register_context_engine`, `register_image_gen_provider`
    # `register_slack_action_handler`, `register_middleware`

Limitations

Format LSP

Bien que les LSP puissent être définis dans .lsp.json, une meilleure approche consiste à les définir en ligne dans plugin.json car leur format varie selon les agent runtimes.

Variables d’environnement des hooks

Dans la plupart des cas, les hooks appellent des scripts personnalisés (shell, powershell, bash, js, etc.) et utilisent des variables d’environnement prédéfinies pour les localiser (par exemple PLUGIN_ROOT, CLAUDE_PLUGIN_ROOT, CLAUDE_PLUGIN_DATA, etc.).

Cependant, avec certains agent runtimes (par exemple VSCode Chat), ces variables ne sont pas correctement définies sur les environnements distants (par exemple WSL ou SSH) lorsque l’OS hôte diffère de celui du distant.

Voir microsoft/vscode#313201 et microsoft/vscode#326166 pour plus de détails.