Agent Package Manager

L’Agent Package Manager (APM) installe des packages, des plugins (directement) ou via des marketplaces.

Contrairement aux plugins installés nativement par chaque agent runtime, le CLI APM se charge de placer les composants au bon endroit pour chaque agent runtime, afin qu’ils puissent être utilisés sans configuration supplémentaire (.agents, .claude, .copilot, .github, etc.), élargissant ainsi la compatibilité entre agent runtimes.

Utilisation

L’installation peut se faire au sein de dépôts (pour avoir des dépendances ou plugins limités à un dépôt) ou à l’échelle utilisateur. La gestion de la portée se fait via le flag --global / -g.

Pour installer des composants pour des agent runtimes spécifiques uniquement, utilisez la propriété target(s).

Installez n’importe quel package depuis n’importe où (dépôt Git, répertoire local, composant distant, etc.).

curl -fSL https://aka.ms/apm-unix | sh
apm install <path_to_primitive>
apm install --mcp <path_to_primitive>

name: my-project
version: 0.1.0
description: Dependencies for project

dependencies:
  apm: []
  mcp: []
  lsp: []

targets: [claude, codex, copilot, gemini, kiro, opencode, windsurf]

Note

L’installation de plugin ne doit être considérée que comme une fonctionnalité de rétrocompatibilité pour les plugins (ou marketplaces) existants sans manifest APM (pas de apm.yml ni de .apm).

Installez n’importe quel plugin depuis n’importe quel marketplace, à l’échelle utilisateur ou dépôt.

curl -fSL https://aka.ms/apm-unix | sh
apm marketplace add <owner>/<repo>
apm install <package-name>@<marketplace-name>

Fichier de verrouillage

Chaque installation est tracée dans un fichier de verrouillage afin que les équipes utilisent exactement les mêmes dépendances et plugins (similaire à package-lock.json).

Échelle utilisateur (flag -g) :

~/.apm/
  └── apm.lock.yaml

Échelle dépôt (par défaut), destiné à être commité :

repository/
└── apm.lock.yaml

Limitations

Espace de nommage

Les composants de type slash installés avec APM n’ont pas de namespace (par exemple /plugin:skill-name) et sont donc susceptibles aux conflits de nommage.