콘텐츠로 이동

빠른 시작

pubm은 여러 레지스트리, 여러 패키지, 또는 여러 생태계에 배포하는 프로젝트를 위한 릴리스 오케스트레이터입니다.

pubm은 이미 Git을 사용하고 유효한 패키지 매니페스트가 있는 저장소를 대상으로 설계되었습니다.

  • Git 2.11+
  • package.json 같은 패키지 매니페스트
  • publish 전에 깨끗한 작업 트리

pubm 자체는 Bun으로 빌드된 단일 바이너리로 배포됩니다. CLI를 실행하기 위해 별도의 Node.js 런타임은 필요하지 않지만, npm 기반 설치는 여전히 패키지 매니저 도구체인을 사용합니다.

CLI를 전역 설치합니다.

Terminal window
# npm
npm i -g pubm
# Homebrew
brew tap syi0808/pubm
brew install pubm

Claude Code, Codex 또는 다른 코딩 에이전트를 통해 pubm을 연결하는 경우, 릴리스 프롬프트를 직접 쓰기보다 설정 자동화부터 시작합니다.

  • pubm setup-skills를 실행해 코딩 에이전트 스킬을 직접 다운로드하고 설치하거나, pubm init이 마지막 단계에서 스킬 설치를 제안하도록 합니다.
  • 또는 pubm plugin 번들의 publish-setup 스킬을 사용해 릴리스 워크플로를 설치하고, 설정을 생성하며, CI를 연결하고, changeset을 활성화합니다.
  • 에이전트가 번들을 가져와 publish-setup부터 시작할 수 있도록 INSTALLATION.md 링크를 제공합니다.
  • 통합 모델과 스킬 역할은 코딩 에이전트 통합에서 확인합니다.

대화형 설정 마법사를 실행합니다.

Terminal window
pubm init

마법사는 패키지와 레지스트리를 감지한 뒤, 브랜치 설정, 버전 전략, changelog, changeset, CI 워크플로 생성, 코딩 에이전트 스킬까지 단계별로 안내합니다. 선택 사항이 기본값과 다를 때만 설정 파일이 생성됩니다.

릴리스 흐름을 시작합니다.

Terminal window
pubm

보류 중인 changeset이 있으면 pubm은 릴리스 파이프라인의 버전 단계에서 이를 소비합니다. changeset이 없는 패키지의 경우 pubm은 conventional commits(feat:, fix: 등)를 폴백으로 분석할 수도 있습니다 — 자세한 내용은 Changesets를 참조합니다. 설정 세부 내용은 Configuration에서, CI와 토큰, CI 준비 동작은 CI/CD에서, 모노레포는 Monorepo에서, 정확한 플래그와 하위 명령은 CLI Reference에서 확인합니다.