휴대폰으로 Kilo 세션 이어가기 (모니터링, 승인, 후속 메시지)

Kilo는 키보드 앞에 있을 때 정말 쾌적한 CLI입니다.

하지만 중요한 세션일수록 시간이 걸립니다.

의존성 업데이트
기계적인 리팩터링
"파일 30개를 건드리는" 변경

워크플로가 "끝날 때까지 터미널 앞에 있기"여서는 안 됩니다.

이 가이드는 리포지토리가 있는 컴퓨터에서 Kilo를 실행하고 휴대폰으로 세션을 이어가는 방법을 다룹니다.

요약

세션을 실행할 컴퓨터에 Kilo를 설치합니다(kilo --version).
Kilo의 /connect 흐름으로 인증합니다.
Kilo 인증 상태가 Unknown으로 보이는 건 정상입니다. Kilo 인증 확인은 보수적입니다.
Kilo를 찾지 못하면 HAPPIER_KILO_PATH를 kilo 바이너리의 절대 경로로 설정합니다.
휴대폰에 맞는 세션 UI로 진행 상황을 모니터링하고, 승인을 처리하고, 후속 메시지를 보냅니다.

문제

Kilo는 로컬 CLI 기반 프로바이더입니다.

리포지토리와 도구가 로컬에 있다는 점이 바로 장점입니다.

하지만 그 말은:

세션이 특정 컴퓨터에 있다
그 컴퓨터가 절전 모드에 들어가면 세션이 멈춘다
SSH밖에 없다면 휴대폰이 터미널이 된다

그래서 좋은 "휴대폰 워크플로"는 주로 가시성과 작은 개입입니다.

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

휴대폰에서 SSH
원격 데스크톱
기다리기

더 짧은 루프가 낫습니다. 확인하고, 승인하고, 살짝 밀어 주고, 멈추기.

Happier: 코딩 에이전트를 크로스 디바이스로 실행하고 오케스트레이션하는 오픈 소스 앱입니다. 세션 모니터링, 승인, 후속 메시지를 위한 휴대폰 UI를 제공합니다. 트레이드오프: 세션을 실행하는 컴퓨터가 온라인 상태여야 합니다.

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

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

이 가이드에서 중요한 개념은 이렇습니다. Kilo는 리포지토리가 있는 컴퓨터에서 실행되고, Happier는 SSH에 붙어 있지 않고도 휴대폰으로 감독하는 수단입니다.

설정하기:

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

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

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

npm install -g @kilocode/cli@latest
kilo --version

hstack을 쓴다면:

hstack providers install kilo
kilo --version

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

2단계: Kilo 인증 (/connect)

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

문서에서 핵심은 Kilo가 /connect 흐름을 쓴다는 점입니다.

그래서 "인증되지 않음"이 보여도 추측할 필요 없이 connect 흐름을 실행한 뒤 다시 확인하면 됩니다.

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

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

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

한 번 동작하면 인증은 신경 쓰지 않아도 됩니다.

3단계: 인증이 "Unknown"으로 표시되는 이유 이해

소스에서 Kilo 인증 확인은 parser: 'unknown'으로 지정되어 있습니다.

의도적인 설계입니다. 백그라운드에서 위험한 확인을 실행하는 것보다 "Unknown"을 보여 주는 편이 안전합니다.

그러니 Unknown은 "고장"이 아니라 "안전하게 확인할 수 없음"으로 받아들이세요.

4단계: HAPPIER_KILO_PATH로 Kilo 감지 문제 해결

Kilo를 설치했는데 감지되지 않으면:

kilo --version이 동작하는지 확인
그런 다음 HAPPIER_KILO_PATH를 절대 경로로 설정

이 재정의는 CLI 테스트에서 검증되므로 실제 구현과 일치합니다.

5단계: 휴대폰 워크플로

잘 통하는 휴대폰 워크플로는 일부러 단순합니다.

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

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

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

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

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

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

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

체크포인트

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

변경한 것

변경하지 않은 것

다음에 하려는 것

제약

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

diff 먼저

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

본격적인 대화형 터미널 작업이 필요하다면 키보드 앞으로 돌아올 때까지 기다리세요.

Happier가 처음이라면

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

설정하기:

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

문제 해결

세션이 업데이트되지 않음

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

Kilo 인증이 "Unknown"으로 표시됨

정상입니다. 소스에서 Kilo 인증 확인은 parser: 'unknown'으로 지정되어 있습니다.

"고장"이 아니라 "안전하게 확인할 수 없음"으로 받아들이세요.