설치

KanVibe는 macOS 데스크톱 앱으로 배포되며, 현재 권장 설치 경로는 Homebrew Cask입니다.

사전 요구사항

의존성	필수	설명	설치 예시
Git	필수	branch와 worktree 생성 및 정리	`brew install git`
tmux	권장	기본 세션 백엔드. 세션 타입을 `terminal`로 바꾸면 없어도 동작합니다	`brew install tmux`
GitHub CLI `gh`	필수	PR URL 조회와 GitHub 워크플로우	`brew install gh` 후 `gh auth login`
zellij	선택	tmux 대신 사용할 수 있는 세션 백엔드	`brew install zellij`

멀티플렉서 없이 쓰려면 세션 타입을 terminal로 고르면 됩니다. 대신 그 세션의 셸은 KanVibe가 직접 들고 있어서, 앱을 끄거나 원격 연결이 끊기면 실행 중이던 작업도 함께 사라집니다. 오래 도는 작업을 맡길 계획이라면 tmux나 zellij를 설치해 두는 편이 안전합니다.

Homebrew로 설치

brew install --cask rookedsysc/kanvibe/kanvibe
open -a KanVibe

공식 Homebrew Cask 등록 후에는 아래 명령으로 설치할 수 있습니다.

brew install --cask kanvibe

업데이트와 제거

brew update
brew upgrade --cask kanvibe

brew uninstall --cask kanvibe
brew untap rookedsysc/kanvibe

첫 실행 체크리스트

1. 프로젝트 등록

보드 toolbar의 돋보기 디렉터리 스캔 버튼을 누르고 로컬/원격 git 저장소를 선택합니다. KanVibe가 worktree 브랜치를 스캔합니다.

2. 세션 타입 확인

tmux를 기본값으로 쓰거나, zellij를 설치했다면 기본 세션 타입을 바꿉니다. 멀티플렉서를 쓰지 않겠다면 terminal을 고릅니다.

3. 알림 권한 허용

AI 에이전트 hooks 상태 변경을 놓치지 않도록 시스템 알림 권한을 허용합니다.