Quick Start

pubm koordiniert Releases für Projekte, die in mehrere Registries, mehrere Pakete oder mehrere Ökosysteme veröffentlichen.

Bevor du startest

pubm ist für Repositories gedacht, die bereits Git nutzen und ein gültiges Paket-Manifest haben.

Git 2.11+
ein Paket-Manifest wie package.json
ein sauberer Working Tree vor dem Veröffentlichen

pubm selbst wird als von Bun gebautes Einzelbinary ausgeliefert. Für die CLI brauchst du also keine separate Node.js-Laufzeit, auch wenn die npm-Installation weiterhin deine Paketmanager-Toolchain nutzt.

Installiere die CLI global:

# npm
npm i -g pubm

# Homebrew
brew tap syi0808/pubm
brew install pubm

Für Coding Agents

Wenn du pubm über Claude Code, Codex oder einen anderen Coding Agent einbindest, fang mit der Setup-Automatisierung an, statt Release-Prompts von Hand zu schreiben.

Führe pubm setup-skills aus, um Coding-Agent-Skills direkt herunterzuladen und zu installieren, oder lass pubm init die Skill-Installation als letzten Schritt anbieten.
Alternativ verwende den Skill publish-setup aus dem pubm plugin-Bundle, um den Release-Workflow einzurichten, Konfiguration zu erzeugen, CI anzubinden und Changesets zu aktivieren.
Gib deinem Agenten den Link INSTALLATION.md, damit er das Bundle abrufen und mit publish-setup loslegen kann.
Lies Coding Agent Integration für das Integrationsmodell und die Rollen der Skills.

1. Repository initialisieren

Starte den interaktiven Setup-Wizard:

pubm init

Der Wizard erkennt deine Pakete und Registries und führt dich dann durch Branch-Konfiguration, Versionsstrategie, Changelog, Changesets, CI-Workflow-Erzeugung und Coding-Agent-Skills. Eine Config-Datei wird nur dann geschrieben, wenn deine Auswahl von den Standardwerten abweicht.

2. Veröffentlichen

Starte den Release-Flow:

pubm

Wenn ausstehende Changesets existieren, verarbeitet pubm sie während des Versionsschritts der Release-Pipeline. Für Pakete ohne Changesets kann pubm auch Conventional Commits (feat:, fix:, etc.) als Fallback analysieren — siehe Changesets für Details. Für Konfigurationsdetails lies Configuration. Für CI, Tokens und das Verhalten der CI-Vorbereitung lies CI/CD. Für Monorepos lies Monorepo. Für exakte Flags und Subcommands lies die CLI Reference.