SSH 없이 휴대폰으로 Kiro 세션 따라가기
컴퓨터에서 Kiro를 실행하고 휴대폰으로 모니터링하는 프로바이더별 가이드. kiro-cli login, 보수적인 인증 감지, "Unknown"의 실제 의미를 다룹니다.
- CLI
- 0.2.17
- 프리뷰 ref
- a2c45c8
Kiro는 보통 "진짜" 컴퓨터에서 실행하는 프로바이더입니다.
- 리포지토리가 있는 노트북
- 개발용 머신
- 서버
그리고 자리에서 일어나는 순간, 누구나 같은 것을 원합니다.
- 아직 실행 중인지 확인
- 입력이 필요한지 확인
- 후속 메시지 하나 보내기
많은 사람이 여기서 SSH를 기본으로 씁니다.
이 가이드는 그 대안입니다. 리포지토리가 있는 곳에서 Kiro를 실행하고 휴대폰으로 따라갑니다.
요약
- 세션을 실행할 컴퓨터에 Kiro CLI를 설치합니다(
kiro-cli --version). kiro-cli login으로 로그인합니다.- 인증 상태를 과하게 해석하지 마세요.
- Kiro 인증 확인은 보수적이라 로그인이 정상이어도 Unknown으로 표시될 수 있습니다.
- 내부적으로는 안전한 상태 명령을 쓸 수 있을 때
kiro-cli whoami --format json으로 확인합니다.
- 휴대폰에 맞는 세션 UI로 트랜스크립트를 따라가고 승인을 처리합니다.
문제
휴대폰으로 로컬 CLI 세션을 따라가는 일은 주로 두 가지에 달려 있습니다.
- 세션을 실행하는 컴퓨터와의 안정적인 연결
- "로그인되어 있는지, 준비되었는지"에 대한 확실한 파악
Kiro는 인증 확인을 수동 전용으로 취급하기 때문에 이 부분이 특히 엄격합니다.
그래서 워크플로를 명확히 해 두어야 합니다.
일반적인 방법과 트레이드오프
-
SSH: 동작하지만 휴대폰에서 터미널 작업을 하게 됩니다.
-
키보드 앞으로 돌아올 때까지 기다리기: 안전하지만 느립니다.
-
Happier: 코딩 에이전트를 크로스 디바이스로 실행하고 오케스트레이션하는 오픈 소스 앱입니다. 세션을 따라가고, 승인을 처리하고, 후속 메시지 하나를 보낼 수 있는 휴대폰 UI를 제공합니다. 트레이드오프: 세션을 실행하는 컴퓨터가 온라인 상태여야 합니다.
Happier가 처음이라면 (무엇이고 어디서 받는지)
Happier를 처음 본다면: 코딩 세션을 위한 오픈 소스 컴패니언 앱(모바일/웹/데스크톱)입니다.
설정하기:
- GitHub: https://github.com/happier-dev/happier
- 설치/다운로드: https://github.com/happier-dev/happier#how-it-works
- Discord: https://discord.gg/W6Pb8KuHfg
1단계: Kiro 설치
프로바이더 문서에 따라 다음을 확인합니다:
kiro-cli --version2단계: 로그인 (머신별)
Kiro는 머신별 로그인을 사용합니다:
kiro-cli login즉:
- 노트북에서 로그인해도 서버는 로그인되지 않는다
실용적인 로그인 체크리스트
세션을 실행할 컴퓨터에서:
kiro-cli --version을 실행합니다.kiro-cli login을 실행합니다.- 계정을 명시적으로 확인합니다:
kiro-cli whoami --format json사용자/계정 정보가 출력되면 그 컴퓨터에서 로그인된 것입니다.
한 번 동작하면 무언가 바뀌지 않는 한 인증은 신경 쓰지 않아도 됩니다.
3단계: 인증 상태가 "Unknown"일 수 있는 이유 이해
소스에서 Kiro 인증 확인은 다음과 같이 정의되어 있습니다:
statusCommand: ['whoami', '--format', 'json']parser: 'kiroWhoamiJson'- 백그라운드 확인:
manual_only
마지막 항목이 "Unknown"이 버그가 아닌 이유입니다.
백그라운드에서 적극적으로 확인하지 않는다는 안전 정책입니다.
4단계: 휴대폰 워크플로
휴대폰 루프는 일부러 작게 잡았습니다.
하나의 루프로:
- 세션 열기
- 승인을 기다리는지 확인
- 후속 메시지 하나 보내기
- 나가기
휴대폰에서 할 일 (그리고 건너뛸 일)
휴대폰에서 해도 괜찮은 일:
- 승인
- 짧은 제약("다음 단계 후에 멈춰", "먼저 요약해")
- diff 빠르게 훑어보기
휴대폰에서는 피하는 게 좋은 일:
- 큰 리팩터링
- 경로나 명령을 확인할 수 없는 작업
Kiro에 잘 맞는 복사용 후속 메시지 3가지
- 체크포인트
다음 단계가 끝나면 멈추고 다음을 요약해 줘:
- 변경한 것
- 변경하지 않은 것
- 다음에 하려는 것
- 제약
마이그레이션/인증은 건드리지 마. 필요하다고 생각되면 멈추고 물어봐.
- 검증
계속하기 전에 지금 실행하려는 명령을 그대로 붙여 넣고 이유를 설명해 줘.
세션에 본격적인 터미널 작업이 필요하다면 키보드 앞으로 돌아올 때까지 기다리세요.
Happier가 처음이라면
Happier를 처음 본다면: Kiro를 카탈로그에 정의된 ACP 프로바이더로 실행할 수 있고, 휴대폰으로 세션을 따라가기 쉽게 해 주는 오픈 소스 컴패니언 앱입니다.
설정하기:
- GitHub: https://github.com/happier-dev/happier
- 설치/다운로드: https://github.com/happier-dev/happier#how-it-works
- Discord: https://discord.gg/W6Pb8KuHfg
문제 해결
분명 로그인했는데 Kiro가 로그아웃 상태로 표시됨
kiro-cli whoami --format json실행- 계정 정보가 출력되면 로그인은 성공한 것
출력되지 않으면 그 컴퓨터에서는 로그인되어 있지 않은 것입니다(다른 컴퓨터에서 로그인했더라도).
세션이 업데이트되지 않음
- 컴퓨터가 온라인이고 세션 런타임이 아직 실행 중인지 확인
- 승인을 기다리는지 확인
- 세션을 새로 고치거나 다시 열기
Kiro에서 stderr 잡음이 보임
Happier는 Kiro 전용 전송 계층을 사용해, 알려진 선택적 알림의 "method not found" stderr 패턴을 억제합니다.
그래서 한 번만 나오는 경고라면 무해할 수 있습니다.
FAQ
컴퓨터마다 인증 상태가 다르게 보이는 이유는?
Kiro 로그인이 머신별이기 때문입니다.
컴퓨터가 여러 대라면 각각 kiro-cli login이 필요합니다.
"수동 전용" 인증 확인은 무슨 뜻인가요?
앱이 백그라운드에서 Kiro 인증 상태를 적극적으로 확인하지 않는다는 뜻입니다. "Unknown"은 안전한 상태이며 반드시 고장을 의미하지는 않습니다.