AI 코딩 도구는 유용하지만, 제대로 리뷰하지 않은 변경 사항을 커밋하는 건 불편합니다.

책상 앞에서는 쉽습니다. 휴대폰에서는 번거로워집니다.

• SSH는 실제 상태를 보여 주지만, 작은 화면에서 diff를 리뷰하고 정확하게 스테이징하는 건 지칩니다.
• GitHub 모바일은 PR 리뷰에는 좋지만, 내 머신에 커밋되지 않은 채 남아 있는 변경 사항에는 별 도움이 되지 않습니다.
• 원격 데스크톱은 동작하지만, 잘못 눌러서 엉뚱한 커밋을 만들기 쉽습니다.

도움이 되는 건 이런 경험에 가깝습니다.

"진짜 리뷰처럼 diff 묶음을 스크롤하고, 파일을 열어 살펴보고, 작은 수정 하나를 한 뒤 넘어가기."

이 워크플로는 휴대폰에서 SSH, 원격 데스크톱, GitHub 모바일을 쓸 때 흔히 생기는 트레이드오프를 피합니다.

요약

1. Happier를 설정하고(또는 Direct sessions로 연결하고) 휴대폰에서 세션을 엽니다.
2. Source control → Review로 이동합니다.
3. 커밋하지 않은 diff 전체를 스크롤하고, 다 본 것은 접어 둡니다.
4. 이상한 부분이 보이면 해당 파일을 에디터 탭에서 열어 고친 뒤 Review로 돌아옵니다.
5. diff를 믿을 수 있게 되면 스테이징하거나 커밋할 수 있습니다. 또는 "리뷰만" 하고 나중에 노트북에서 커밋해도 됩니다.

문제

에이전트가 많은 파일(또는 중요한 파일 몇 개)을 바꿨다면, 커밋 전에 두 가지 질문에 답해야 합니다.

• 무엇이 바뀌었나? (어떤 파일인지뿐 아니라 실제 diff 내용)
• 믿을 수 있나? (올바른 변경인지, 범위가 적절한지, 예상치 못한 것이 섞여 있지 않은지)

휴대폰에서 흔한 실패는 도구가 불편해서 꼼꼼한 리뷰를 그만두는 것입니다.

흔한 방법과 트레이드오프

• SSH + git diff는 동작하지만, 휴대폰에서는 대충 훑어보다가 "잠깐, 이 파일은 왜 바뀌었지?" 하는 순간을 놓치기 쉽습니다.
• 원격 데스크톱은 동작하지만, 모바일에서 잘못 눌러 엉뚱한 수정을 하기 쉽습니다.
• GitHub 모바일은 PR 리뷰에는 좋지만, 머신에 있는 커밋되지 않은 작업 트리는 보여 주지 않습니다.

도움이 되는 건 휴대폰에서 쓸 수 있는 리뷰 화면입니다. PR처럼 diff를 스크롤하고, 파일로 들어가고, 하나를 고치고, 계속 진행하는 것입니다.

• Happier: 코딩 에이전트를 크로스 디바이스로 실행하고 오케스트레이션하는 오픈 소스 앱입니다. 저장소는 내 머신에 그대로 둔 채, 휴대폰에서 "PR처럼 diff 묶음을 스크롤하는" 화면을 제공합니다. 트레이드오프: 머신이나 데몬에 연결할 수 없으면 다시 SSH나 원격 데스크톱으로 돌아가야 합니다.

개념: 변경 파일 목록과 "Review"

변경 파일 목록은 "어떤 파일이 바뀌었나?"에 답합니다.

리뷰 화면은 "어떤 작업이 이루어졌나?"에 답합니다.

Happier의 Review 화면은 "실제 작업을 스크롤하며 확인하는" 화면입니다.

• diff가 점진적으로 렌더링됨
• 다 본 파일은 접을 수 있음
• 위치를 잃지 않고 에디터로 이동할 수 있음

이 점 덕분에 작은 터미널보다 모바일에서 리뷰하기가 훨씬 수월해집니다.

Happier가 처음이라면 (무엇이고 어디서 받는지)

Happier는 Claude Code, Codex, OpenCode 같은 AI 코딩 에이전트를 위한 오픈 소스 컴패니언 앱(모바일 / 웹 / 데스크톱)입니다.

여기서의 워크플로는 저장소와 Git은 워크스페이스를 소유한 머신에 두고, Happier로 휴대폰에서 바로 diff를 리뷰하는 것입니다.

이 가이드에서는, 원격 데스크톱에 의존하지 않고 모바일에서 실제 커밋되지 않은 작업 트리 diff를 리뷰할 수 있다(작은 수정도 할 수 있다)는 뜻입니다.

설정 시작하기:

• 휴대폰에서 Happier 사용하는 방법
• GitHub: https://github.com/happier-dev/happier
• 설치 / 다운로드: https://github.com/happier-dev/happier#how-it-works
• Discord (커뮤니티 및 지원): https://discord.gg/W6Pb8KuHfg

단계별: 휴대폰에서 커밋되지 않은 diff 리뷰하기

1) Source control 열기

세션 화면에서 Source control을 엽니다.

브랜치 요약과 변경 파일 목록이 보여야 합니다.

2) Review 열기

Review를 엽니다.

이제 PR을 리뷰하듯 diff 전체를 스크롤합니다.

• 다 본 파일은 접기
• 의심스러운 부분이 보이면 멈추기

3) 작은 문제를 살펴보고 고치기 (위치를 잃지 않고)

작은 문제(이름, 남아 있는 디버그 로그, 잘못된 설정 수정)를 발견하면:

• 해당 파일을 에디터에서 열기
• 수정하기
• Review로 돌아가 계속하기

핵심은 리뷰가 끊기지 않는다는 점입니다. 맥락을 계속 바꿀 필요가 없습니다.

4) 다음에 할 일 정하기

꼼꼼히 리뷰한 뒤에는 몇 가지 합리적인 결과가 있습니다.

• 리뷰만: 변경을 믿을 수 있으니 나중에 노트북에서 스테이징하거나 커밋합니다.
• 지금 스테이징하거나 커밋 (Git 작업이 활성화되어 있고 모바일에서 해도 괜찮다면).
• 에이전트에게 후속 지시 보내기 ("이 두 파일을 고치고, 이건 되돌리고, 커밋을 나눠 줘").

첨부 파일과 프로젝트 파일 (혼동하지 마세요)

변경 사항을 리뷰할 때는 첨부 파일이 아니라 워크스페이스 파일(저장소)을 보고 있는지 확인하세요.

첨부 파일은 로그나 일회성 결과물을 모델에 보낼 때 유용하지만, 커밋하려는 저장소 파일과는 다릅니다.

흔한 실수

• 파일 목록만 리뷰하기 (diff를 보지 않음) → 실제로 위험한 변경을 놓칩니다.
• 모바일 터미널에서 리뷰하며 서두르기 → 데스크톱이었다면 승인하지 않았을 것을 승인하게 됩니다.
• GitHub 모바일이 내 머신을 반영한다고 생각하기 → 변경이 이미 PR에 push되지 않았다면 반영하지 않습니다.

문제 해결

증상: Source control이나 diff가 보이지 않음

가능한 원인:

• 세션을 소유한 머신이나 데몬에 연결할 수 없음
• 다른 서버나 프로필을 사용 중

해결:

1. 올바른 서버에 연결되어 있는지 확인합니다.
2. 머신이 온라인이고 연결 가능한지 확인합니다.

증상: 파일이 바뀐 걸 아는데 Review가 비어 있음

가능한 원인:

• 다른 저장소나 워크스페이스를 보고 있음
• SCM 백엔드가 아직 새로 고쳐지지 않음

해결:

• 변경 파일 목록으로 돌아가 올바른 저장소 맥락에 있는지 확인합니다

자주 묻는 질문

커밋하지 않고 휴대폰에서 diff를 리뷰할 수 있나요?

네. 그리고 이 방식이 적절한 기본값인 경우가 많습니다.

휴대폰에서 리뷰하고, 실제 커밋과 push는 도구가 갖춰진 노트북에서 나중에 하세요.

AI가 생성한 코드를 리뷰하는 데 이 정도면 충분한가요?

첫 번째 점검으로는 충분합니다. 특히 눈에 띄는 범위 문제를 잡는 데 좋습니다.

위험도가 높은 변경은 머지 전에 노트북에서 더 깊이 리뷰하세요(또는 다른 에이전트에게 리뷰를 맡기세요).

관련 가이드

• 휴대폰에서 Happier 사용하는 방법
• 휴대폰에서 코드 커밋하는 방법