휴대폰으로 Augment(Auggie) 세션 모니터링하기

Augment는 "일단 코딩을 시작하는" 느낌이 있습니다.

단점은 Auggie 세션이 도는 동안 노트북을 지켜봐야 한다는 점입니다.

작업이 20~60분 걸린다면 다음이 가능한 워크플로가 필요합니다.

리포지토리가 있는 컴퓨터에서 세션 시작
컴퓨터에서 떠나기
휴대폰으로 진행 상황 확인
프롬프트/승인에 응답
후속 메시지 하나 보내기

이 가이드가 그 워크플로입니다.

요약

Auggie를 설치하고 세션을 실행할 컴퓨터에서 auggie --version을 확인합니다.
휴대폰 워크플로(Happier가 한 가지 방법)로 세션을 모니터링하고, 승인을 처리하고, 후속 메시지를 보냅니다.
Augment 인증 상태가 Unknown으로 보여도 당황하지 마세요. Auggie 인증 확인은 보수적입니다.
Auggie를 찾지 못하면 HAPPIER_AUGGIE_PATH를 auggie 바이너리의 전체 경로로 설정합니다.

문제

"휴대폰으로 모니터링"이 실패하는 이유는 보통 세 가지 중 하나입니다.

세션이 절전 모드에 들어가는 컴퓨터에서 실행된다(세션이 죽는다)
SSH밖에 없다(휴대폰이 터미널이 된다)
인증/상태가 모호하다(보고 있는 것을 믿을 수 없다)

Auggie는 로컬 CLI 기반 프로바이더입니다. 코드가 리포지토리가 있는 곳에 머문다는 점은 장점입니다.

하지만 휴대폰 워크플로는 의도적으로 설계해야 합니다.

일반적인 방법과 트레이드오프

휴대폰에서 SSH: 동작하지만 작은 터미널에서 긴 출력을 읽기 어렵습니다.
원격 데스크톱: 무겁고 번거롭습니다.
키보드 앞으로 돌아올 때까지 기다리기: 안전하지만 느립니다.
Happier: 코딩 에이전트를 크로스 디바이스로 실행하고 오케스트레이션하는 오픈 소스 앱입니다. 휴대폰에서 Augment 세션을 열어 진행 상황을 확인하고, 승인을 처리하고, 짧은 후속 메시지 하나로 실행을 이어갈 수 있습니다. 트레이드오프: Auggie를 실행하는 컴퓨터가 온라인 상태여야 합니다.

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

Happier를 처음 본다면: 코딩 세션을 위한 오픈 소스 컴패니언 앱(모바일/웹/데스크톱)입니다.

이 가이드에서 중요한 개념은 간단합니다.

Auggie는 리포지토리가 있는 컴퓨터에서 실행된다
Happier는 휴대폰에서 세션을 감독하는 곳이다(진행 상황, 승인, 후속 메시지 하나)

설정하기:

GitHub: https://github.com/happier-dev/happier
설치/다운로드: https://github.com/happier-dev/happier#how-it-works
Discord: https://discord.gg/W6Pb8KuHfg

1단계: 세션을 실행할 컴퓨터에 Auggie 설치

프로바이더 문서에 따르면:

npm install -g @augmentcode/auggie
auggie --version

hstack을 쓴다면 설치 도구도 있습니다:

hstack providers install auggie
auggie --version

(hstack을 처음 들어본다면: Happier 생태계의 선택형 도우미로, 프로바이더 CLI를 설치해 줍니다. 꼭 필요하지는 않으며 npm install -g ...로도 충분합니다.)

중요한 건 설치 방법이 아닙니다.

세션을 실행할 컴퓨터에서 auggie --version이 동작하는지입니다.

2단계: Auggie 인증 이해하기 (상태가 "Unknown"일 수 있는 이유)

Auggie는 프로바이더 설정에서 자체 로그인 흐름을 실행할 수 있습니다.

하지만 Auggie 인증 확인은 보수적입니다.

Happier 에이전트 인증 확인 설정에서 Auggie는 unknown 파서를 사용합니다. 즉:

Happier는 위험한 확인으로 "로그인됨"과 "로그아웃됨"을 추측하지 않는다
모든 게 정상이어도 UI에 Unknown이 표시될 수 있다

그래서 좋은 기준은:

그 컴퓨터에서 auggie login이 동작하면 괜찮다
"Unknown"은 "고장"이 아니라 "안전하게 확인할 수 없음"으로 받아들인다

실용적인 로그인 체크리스트

세션을 실행할 컴퓨터에서:

auggie --version을 실행합니다.
auggie login을 실행합니다(또는 프로바이더 설정에서 실행).
작은 세션 하나를 시작하고 후속 메시지를 보낼 수 있는지 확인합니다.

한 번 동작하면 문제가 생길 때까지 인증은 신경 쓰지 않아도 됩니다.

3단계: HAPPIER_AUGGIE_PATH로 "Auggie를 찾을 수 없음" 해결

세션 컴퓨터에서 auggie는 실행되는데 앱이 찾지 못한다면 원인은 보통 PATH입니다.

Happier는 바이너리 재정의 환경 변수를 지원합니다:

HAPPIER_AUGGIE_PATH

auggie 실행 파일의 절대 경로로 설정하세요.

이 재정의는 CLI 백엔드 테스트에서 실제로 검증됩니다(문서상의 약속만이 아닙니다).

4단계: 세션을 시작하고 휴대폰을 모니터로 사용

휴대폰 워크플로는 일부러 좁게 잡았습니다.

하나의 루프로:

세션 열기
승인을 기다리는지 확인
후속 메시지 하나 보내기
나가기

휴대폰에서 할 일 (그리고 건너뛸 일)

휴대폰에서 해도 괜찮은 일:

권한 요청을 읽은 뒤 승인 또는 거부
짧은 수정 보내기("이 단계 후에 멈춰", "X는 건드리지 마", "먼저 요약해")
어떤 파일이 바뀌었는지 대략 확인

휴대폰에서는 피하는 게 좋은 일:

큰 리팩터링
복사/붙여넣기가 많이 필요한 작업
경로나 명령을 쉽게 확인할 수 없는 작업

Auggie에 잘 맞는 복사용 후속 메시지 3가지

"휴대폰에서"라는 상황에서는 다음 후속 메시지를 재사용할 만합니다.

체크포인트

다음 단계가 끝나면 멈추고 다음을 요약해 줘:

변경한 것

변경하지 않은 것

다음에 하려는 것

제약

마이그레이션/인증은 건드리지 마. 필요하다고 생각되면 멈추고 물어봐.

diff 먼저

계속하기 전에 수정한 파일과 그 이유를 나열해 줘(파일마다 한 문장).

5단계: 문제 해결 체크리스트

세션이 업데이트되지 않음

컴퓨터가 온라인이고 세션 런타임이 아직 실행 중인지 확인
승인을 기다리는지 확인
세션을 새로 고치거나 다시 열기

노트북 덮개를 닫았고 그 노트북이 호스트라면 세션이 멈췄다고 보세요.

멈춘 건지 알 수 없음

"멈춘 세션" 플레이북을 사용합니다:

승인 대기인지, 오프라인인지, 작업 중인지

Happier가 처음이라면

Happier를 처음 본다면: Augment/Auggie 같은 세션을 한 컴퓨터에서 실행하고 휴대폰으로 모니터링하는 오픈 소스 컴패니언 앱입니다.

워크플로는 기본적으로 다음과 같습니다.

Auggie는 리포지토리가 있는 곳에서 실행된다
Happier에서 진행 상황을 확인하고, 승인을 처리하고, 후속 메시지를 보낸다

(앱을 하나 더 쓰고 싶지 않다면 언제든 SSH로 돌아갈 수 있습니다. 다만 휴대폰에서 SSH를 좋아하는 사람은 많지 않습니다.)

설정하기:

GitHub: https://github.com/happier-dev/happier
설치/다운로드: https://github.com/happier-dev/happier#how-it-works
Discord: https://discord.gg/W6Pb8KuHfg