빠른 시작

필요한 것

• git: 저장소와 worktree를 읽고 커밋하는 데 씁니다.
• Claude Code: 세션 상태 표시와 Belloga 하네스(작업 계획 안내, 규칙 주입)에 필요합니다. 없어도 나머지 기능은 쓸 수 있습니다.

1. 설치

Windows

Windows 설치 파일

GitHub CLI(gh)로 받을 수도 있습니다.

cd ~\Downloads
gh release download --repo 1Dohyeon/belloga --pattern '*.exe'

받은 파일을 열어 설치합니다.

macOS (Apple Silicon)

macOS 설치 파일

GitHub CLI(gh)로 받을 수도 있습니다.

cd ~/Downloads
gh release download --repo 1Dohyeon/belloga --pattern '*.dmg'

받은 dmg를 열어 Belloga를 응용 프로그램 폴더로 옮깁니다.

모든 버전은 GitHub 릴리스에 있습니다. 앱의 언어는 처음에 운영체제 언어를 따르고, 설정의 일반 탭에서 바꿉니다. 다크와 라이트 테마는 설정의 디자인 탭에서 고릅니다.

2. 폴더 연결

처음 켜면 작업 영역에 프로젝트 추가 단추가 보입니다. 누르고 저장소가 든 폴더를 고릅니다. 사이드바 머리의 + 단추나 명령 팔레트(Ctrl+Shift+P, macOS ⌘⇧P)의 프로젝트 추가로도 됩니다.

Belloga는 고른 폴더 안의 git 저장소와 worktree를 찾아 사이드바에 묶어 보여 줍니다. 자세한 규칙은 폴더 연결에 있습니다.

3. worktree 만들기

사이드바의 Git 모드에서 워크트리 탭을 엽니다. 저장소 이름 옆의 +(워크트리 추가)를 누르면 새 워크트리 창이 뜹니다.

1. 브랜치 이름을 적습니다.
2. 폴더 위치를 확인합니다. 기본값이 미리 채워져 있습니다.
3. 작업 계획을 쓰는 저장소라면 작업 유형(새 기능, 버그 수정, 리팩터링, 동작 변경)을 고릅니다.
4. 만들기를 누릅니다.

4. Claude Code 띄우기

새 worktree 카드를 누르면 그 폴더에서 터미널 탭이 열립니다. 터미널에서 claude를 실행하거나, 탭 줄의 새 탭 메뉴에서 Claude를 골라 Claude Code를 바로 띄웁니다.

세션이 일하는 동안 worktree 카드와 탭 제목에 상태가 표시됩니다. 권한 승인을 기다리면 알림이 오고, Ctrl+Shift+A(macOS ⌘⇧A)로 그 탭에 바로 갑니다.

5. 작업 계획 쓰기

설정의 에이전트 탭에서 plan 훅을 켜면, Belloga 터미널에서 시작한 Claude Code 세션이 브랜치마다 작업 계획(requirements.md, design.md, tasks.md)을 쓰도록 안내받습니다. 계획은 저장소 밖 ~/.belloga/plans/{owner}/{repo}/{branch}에 생깁니다.

worktree 카드에 작업 유형과 tasks.md 진행률이 보이고, 누르면 계획 문서가 열립니다. 자세한 내용은 작업 계획에 있습니다.