Démarrage rapide

pubm est un orchestrateur de publication pour les projets qui publient vers plus d’un registry, plus d’un package ou plus d’un écosystème.

Avant de commencer

pubm est conçu pour les dépôts qui utilisent déjà Git et disposent d’un manifest de package valide.

Git 2.11+
Un manifest de package comme package.json
Un arbre de travail propre avant de publier

pubm est distribué sous la forme d’un binaire unique compilé avec Bun. Vous n’avez pas besoin d’un runtime Node.js séparé juste pour exécuter la CLI, même si l’installation via npm utilise toujours la chaîne d’outils de votre gestionnaire de paquets.

Installez la CLI globalement :

# npm
npm i -g pubm

# Homebrew
brew tap syi0808/pubm
brew install pubm

Pour les agents de code

Si vous raccordez pubm via Claude Code, Codex ou un autre agent de code, commencez par l’automatisation de configuration au lieu d’écrire les invites de release à la main.

Exécutez pubm setup-skills pour télécharger et installer les skills pour agents de code directement, ou laissez pubm init proposer l’installation des skills comme dernière étape.
Utilisez alternativement le skill publish-setup du bundle pubm plugin pour installer le workflow de publication, générer la config, raccorder la CI et activer les changesets.
Donnez à votre agent le lien INSTALLATION.md pour qu’il puisse récupérer le bundle et commencer par publish-setup.
Lisez Intégration des agents de code pour le modèle d’intégration et les rôles des skills.

1. Initialiser le dépôt

Lancez l’assistant de configuration interactif :

pubm init

L’assistant détecte vos packages et registries, puis vous guide à travers la configuration de la branche, la stratégie de versioning, le changelog, les changesets, la génération de workflows CI et les skills pour agents de code. Un fichier de config n’est créé que si vos choix diffèrent des valeurs par défaut.

2. Publier

Lancez le flux de release :

pubm

Si des changesets en attente existent, pubm les consomme pendant l’étape de version du pipeline de release. Pour les packages sans changesets, pubm peut également analyser les commits conventionnels (feat:, fix:, etc.) en repli — consultez Changesets pour les détails. Pour les détails de configuration, lisez Configuration. Pour la CI, les tokens et le comportement de préparation CI, lisez CI/CD. Pour les monorepos, lisez Monorepo. Pour les flags et sous-commandes exacts, lisez la Référence CLI.