휴대폰에서 컴퓨터의 커밋 기록과 diff 검토하기
최근 커밋을 검토하고, diff를 열고, 휴대폰에서 "무엇이 바뀌었지?"에 답하는 실용적인 워크플로. 원격 데스크톱이 필요 없습니다.
- CLI
- 0.2.17
- 프리뷰 ref
- a2c45c8
"자리를 비웠을 때" 반복되는 질문이 있습니다.
무엇이 바뀌었지?
"완벽한 아키텍처는?"이 아닙니다.
"다음엔 무엇을 리팩터링하지?"도 아닙니다.
그냥: 무엇이, 어디서 바뀌었고, 믿을 수 있는가.
이런 경우에 나옵니다.
- 팀원이 회귀 문제로 연락했을 때
- 며칠간 안 본 브랜치에서 CI가 실패했을 때
- 릴리스 도중일 때
- 앞서 한 내 변경을 검토할 때
답하는 유일한 방법이 "컴퓨터에 원격 데스크톱으로 접속"이라면 보통 미뤄집니다.
이 가이드는 휴대폰에서 "최근 커밋 검토"를 가능하게 하는 워크플로를 다룹니다.
일반적인 방법과 트레이드오프
- SSH: 빠른 명령에는 좋지만, 휴대폰에서 diff를 눈으로 검토하기엔 좋지 않습니다.
- 원격 데스크톱: 되지만 무겁고 산만합니다.
- Git 호스팅 앱: 변경이 이미 PR에 있다면 좋습니다. 하지만 어디에 호스팅되어 있든(또는 push하기 전에) 컴퓨터의 리포지토리를 검토하고 싶을 때가 있습니다.
실제로 쓸 수 있는 워크플로
이 워크플로는 리포지토리를 가진 컴퓨터 위에서 원격 UI를 사용합니다.
Happier는 이 방식을 지원하는 선택지 중 하나입니다.
각 Happier 세션은 컴퓨터의 리포지토리 폴더에 연결되어 있습니다. 휴대폰에서는 세션의 Git 탭으로 다음을 할 수 있습니다.
- 커밋 기록 둘러보기
- 커밋을 열고 diff 검토하기
기록과 diff를 보는 건 실험적 Git 쓰기 작업을 켜지 않아도 됩니다.
트레이드오프: 컴퓨터가 온라인이어야 합니다.
Happier가 처음이라면 (무엇이고 어디서 받는지)
Happier를 처음 본다면: 신뢰하는 컴퓨터에 워크플로를 두고 휴대폰에서 관리할 수 있게 해 주는 오픈 소스 컴패니언 앱(모바일/웹/데스크톱)입니다.
설정하기:
- 휴대폰에서 Happier 사용하는 방법
- GitHub: https://github.com/happier-dev/happier
- 설치/다운로드: https://github.com/happier-dev/happier#how-it-works
- Discord (커뮤니티 + 지원): https://discord.gg/W6Pb8KuHfg
단계별: 휴대폰에서 커밋 기록 검토하기
1) 리포지토리 폴더에서 세션 열기
리포지토리에서 실행 중인 세션을 열거나, 리포지토리 폴더를 작업 디렉터리로 해서 세션을 시작합니다.
2) Git 탭의 기록 열기
세션 안에서:
- Git 탭을 엽니다.
- 커밋 기록을 엽니다.
다음이 보입니다.
- Recent commits
- Load more commits 동작
3) 커밋을 열고 diff 검토
간단한 휴대폰 검토 루프:
- 최신 커밋 열기
- 커밋 메시지(의도) 훑어보기
- 위험이 커 보이는 파일 먼저 열기
- 결정: "괜찮음" vs "후속 조치 필요"
"왜 이렇게 됐지?"가 필요하면 기록에서 다음으로 이동할 수 있습니다.
- 현재 작업 트리의 Changed files
4) 맥락이 필요하면 Files 사용
기록은 무엇이 바뀌었는지 알려 줍니다.
때로는 "이 파일은 뭐지?" 같은 맥락도 필요합니다.
그럴 때 엽니다.
- Files
검색하고, 파일을 열어 읽고, 돌아갑니다.
5) 후속 결정 내리기
검토 워크플로 대부분은 행동으로 끝나지 않아서 실패합니다.
휴대폰에서 할 수 있는 유용한 행동:
- 리뷰 코멘트 남기기
- 변경 이유를 한 단락으로 요청하기
- 작은 수정을 대기열에 넣기
- 또는 "괜찮다"고 정하고 넘어가기
터미널 (선택)
내장 터미널을 쓸 수 있으면 세션에 Terminal 탭이 표시됩니다. 기능 매트릭스 (영어)에 따르면 실험적 기능입니다.
일회성 명령(git show, git grep 등)에 쓰고, 기본 워크플로는 UI 중심으로 유지하세요.
FAQ
Changed files만 보지 않고 기록을 쓰는 이유는?
Changed files는 "이 작업 트리에서 지금 무엇이 변경됐나?"에 답합니다.
기록은 "시간에 따라 무슨 일이 있었나?"에 답합니다.
둘 다 유용합니다. 답하는 질문이 다를 뿐입니다.
얼마나 거슬러 올라갈 수 있나요?
Load more commits를 쓰세요.
병합 커밋에도 diff가 표시되나요?
순수 Git에서는 특정 병합 diff 형식을 요청하지 않으면 병합 커밋에 diff가 표시되지 않는 경우가 많습니다.
병합을 검토한다면 무엇을 확인하고 싶은지(first-parent 보기 vs 결합 diff) 더욱 신중하게 정하세요. (출처: https://git-scm.com/docs/git-log)
GitHub에 push하지 않아도 커밋 기록을 검토할 수 있나요?
네.
그게 세션 기반 워크플로의 핵심 이점 중 하나입니다. 이미 push한 것만이 아니라 컴퓨터에 있는 것을 검토할 수 있습니다.
흔한 큰 실패는?
호스트 컴퓨터가 오프라인이 되는 것입니다.
리포지토리 머신을 안정적으로 온라인으로 유지할 수 없다면 어떤 휴대폰 워크플로도 안정적으로 느껴지지 않습니다.
"이 두 시점 사이에 무엇이 바뀌었나"에 휴대폰에서 어떻게 답하나요?
실용적인 방법 두 가지:
- 기록에서 두 커밋을 열고 diff를 하나씩 검토합니다.
- 진짜 "A…B 비교" diff가 필요하면 Terminal에서 일회성으로
git diff <a>..<b>를 씁니다.
터미널은 비상구로 다루세요. 유용하지만 기본은 아닙니다.
"이 버그를 들여온 커밋"은 어떻게 찾나요?
휴대폰에서는 보통 이게 빠른 길입니다.
- 의심 가는 파일에서 시작
- 그 파일을 건드린 최근 커밋 훑기
- 작은 범위로 좁히기
진짜 bisect가 필요하면 보통 키보드에서 할 일입니다.
GitHub에 없는 리포지토리의 커밋 기록도 검토할 수 있나요?
네.
세션은 컴퓨터의 폴더에서 동작합니다.
그 폴더가 Git 리포지토리라면 GitHub, GitLab, 셀프 호스팅 원격에 있든 어디에도 호스팅되지 않았든 기록을 검토할 수 있습니다.
기록은 읽기 전용인가요, 아니면 거기서 변경할 수 있나요?
기록은 검토 화면입니다.
무언가를 바꾸기로 했다면:
- Files를 열어 편집
- 그다음 Git 탭에서 검토하고 커밋(커밋은 실험적 Git 쓰기 작업이며 기본으로 꺼져 있음)
휴대폰에서 커밋 메시지가 잘리는 이유는?
UI에 맞춰야 하기 때문입니다.
커밋 메시지가 잘려 있으면 다음 신호로 받아들이세요.
- 커밋 세부 정보를 탭해서 열기
- 메시지보다 diff에 더 의존하기
큰 변경 묶음을 흐름을 잃지 않고 검토하려면?
휴대폰에 맞는 요령:
- 먼저 상위 1~3개 "위험 파일"(인증, 설정, 마이그레이션, 락 파일)만 검토
- 다시 봐야 할 부분에는 리뷰 코멘트 남기기
- 결정을 내리면 멈추기
휴대폰에서 파일 200개를 완벽하게 검토하려 하면 시간만 쓰고 여전히 놓칩니다.
이 워크플로로 AI 에이전트가 바꾼 걸 검토할 수 있나요?
네. 아주 잘 맞는 사용법입니다.
긴 세션이 어제 변경을 했다면, 다음에 무엇을 할지 정하기 전에 기록이 "실제로 무엇이 들어갔나?"에 답해 줍니다.
대신 리포지토리 호스팅 앱을 써야 할 때는?
변경이 이미 PR로 있다면 호스팅 앱이 좋은 선택일 수 있습니다.
Git 탭 기록이 잘 맞는 경우:
- 변경이 아직 push되지 않음
- 내 로컬 커밋을 검토 중
- 리포지토리가 어디에 호스팅되든 같은 워크플로를 원함