Inicio rápido

pubm es un orquestador de publicaciones para proyectos que publican en más de un registry, más de un paquete o más de un ecosistema.

Antes de empezar

pubm está diseñado para repositorios que ya usan Git y tienen un manifest de paquete válido.

Git 2.11+
Un manifest de paquete como package.json
Un working tree limpio antes de publicar

pubm se distribuye como un binario único compilado con Bun. No necesitas un runtime de Node.js separado solo para ejecutar el CLI, aunque la instalación mediante npm sigue usando tu cadena de herramientas del gestor de paquetes.

Instala el CLI de forma global:

# npm
npm i -g pubm

# Homebrew
brew tap syi0808/pubm
brew install pubm

Para agentes de código

Si estás integrando pubm con Claude Code, Codex u otro agente de código, empieza con la automatización de setup en lugar de escribir prompts de release a mano.

Ejecuta pubm setup-skills para descargar e instalar skills de agentes de código directamente, o deja que pubm init ofrezca la instalación de skills como su paso final.
Alternativamente, usa la skill publish-setup del bundle pubm plugin para instalar el flujo de publicación, generar la configuración, conectar CI y activar changesets.
Dale a tu agente el enlace INSTALLATION.md para que pueda descargar el bundle y empezar con publish-setup.
Lee Agentes de código para conocer el modelo de integración y los roles de cada skill.

1. Inicializar el repositorio

Ejecuta el asistente de configuración interactivo:

pubm init

El asistente detecta tus paquetes y registries, y te guía a través de la configuración del branch, la estrategia de versionado, el changelog, los changesets, la generación de workflows de CI y las skills de agentes de código. El archivo de configuración solo se crea cuando tus elecciones difieren de los valores por defecto.

2. Publicar

Inicia el flujo de release:

pubm

Si hay changesets pendientes, pubm los consume durante la fase de versionado del pipeline de release. Para los paquetes sin changesets, pubm también puede analizar commits convencionales (feat:, fix:, etc.) como replegado — consulta Changesets para más detalles. Para configuración, lee Configuración. Para CI, tokens y comportamiento de preparación de CI, lee CI/CD. Para monorepos, lee Monorepo. Para flags y subcomandos exactos, lee la CLI Reference.