sirloin-nb

Notion 데이터베이스에서 작업 티켓을 선택하여 Git 브랜치를 자동 생성하는 CLI 도구입니다.

nb = Notion Branch

설치

npm install -g sirloin-nb

설정

1. Notion Integration 생성

1. Notion Integrations에서 새 Integration 생성
2. 토큰 복사

2. 데이터베이스에 Integration 연결

1. Notion에서 사용할 데이터베이스 페이지 열기
2. 우측 상단 ... → 연결(Connections) → 생성한 Integration 추가

3. 초기 설정

nb init

NOTION_TOKEN, DATABASE_ID, 티켓 ID 접두사를 입력하면 프로젝트 루트에 .nbrc.json으로 저장됩니다.

.gitignore에 .nbrc.json을 추가하는 것을 권장합니다.

DATABASE_ID 찾는 방법:

https://www.notion.so/workspace/데이터베이스이름-{DATABASE_ID}?v=...
                                              ^^^^^^^^^^^^^^^^
                                              이 32자리가 DATABASE_ID

사용법

프로젝트 디렉토리에서:

nb

실행하면:

1. Notion 데이터베이스에서 task 상태인 티켓 목록을 가져옵니다
2. 번호를 선택합니다
3. 브랜치 타입을 선택합니다 (feature, fix, refactor, chore, hotfix, docs, test)
4. 해당 티켓 기반으로 브랜치를 생성합니다
5. 브랜치가 이미 존재하면 전환 여부를 물어봅니다

예시

🔍 노션에서 'task' 상태의 티켓을 가져오는 중...

--- [할 일] 목록 ---
[0] WEB-42: 로그인 페이지 버그 수정
[1] WEB-43: 회원가입 폼 유효성 검사
[2] WEB-44: 다크모드 구현

브랜치를 생성할 번호를 선택하세요: 0

--- 브랜치 타입 ---
[0] feature   새 기능
[1] fix       버그 수정
[2] refactor  리팩토링
[3] chore     기타 작업
[4] hotfix    긴급 수정
[5] docs      문서 작업
[6] test      테스트

브랜치 타입을 선택하세요 (기본: 0): 1

🌿 Git 브랜치 생성 중: fix/WEB-42-로그인-페이지-버그-수정
✨ 성공! 이제 'fix/WEB-42-로그인-페이지-버그-수정' 브랜치에서 작업을 시작하세요.

요구사항

• Node.js 18+
• Git이 설치되어 있어야 합니다
• Notion 데이터베이스에 상태 (status) 속성과 ID (unique_id) 속성이 있어야 합니다

License

MIT