Pi 에이전트 세션을 위한 올인원 원격 터미널 구축!

다들 안녕,

자리 비웠을 때 Pi로 CLI 에이전트 작업 돌리는데 모바일에서 매끄럽게 쓰고 싶은 사람들은 이거 한번 써봐!

기존 원격 설정들은 진짜 하나같이 다 따로 놀아서 개판이잖아:

• 윈도우에 OpenSSH 깔고, tmux 붙이고, Tailscale/메시 VPN 설정하고, 모바일 SSH 클라이언트까지 쓰는 짓.

• 노트북 절전 모드 들어가면 바로 끊기는 웹 UI 쓰는 거.

• Discord, Telegram, WhatsApp으로 알림 쏘는 거—이러면 정작 중요한 TUI는 다 날아가고 텍스트 쪼가리만 남음.

• 특정 생태계에 묶여버리는 클라우드 호스팅 원격 툴 쓰는 거.

그래서 내가 몇 주 동안 Agent Terminal 만들어서 이 꼴을 하나로 싹 정리해버렸어. 윈도우랑 macOS용 네이티브 터미널 호스트에, QR 코드로 페어링하는 모바일 앱(Android / iOS) 조합이야. 실제 세션은 PC에서 돌아가고, 폰으로는 그냥 보고 제어만 하는 방식이지.

지금 Play 스토어랑 App Store에 정식 출시하기 전에, 실제로 에이전트 작업 돌리면서 이것저것 테스트하고 버그 찾아줄 사람 몇 명 구하는 중이야.

어떻게 만들었냐면:

• 풀 터미널, 스크롤백, 마우스 리포팅, 전체 화면 리드로우, Kitty 키보드 프로토콜 지원 (덕분에 TUI에서 Shift+Enter랑 Enter 같은 단축키도 제대로 먹힘).

• 에이전트 이벤트 훅이나 훅 없는 유휴 상태 감지로 푸시 알림 전송 - 작업 끝나면 바로 알 수 있음.

• Port Bridge - PC의 localhost 포트를 폰 브라우저로 바로 안전하게 포워딩해서, 밖에서도 로컬 개발 서버나 웹 UI 확인 가능.

• 파일 핸들링 - 호스트 데스크탑 파일 미리보기 및 업로드, 폰에서 바로 TUI로 이미지 붙여넣기 가능.

• 호스트 앱은 딱 포트 하나만 열어두는 가벼운 SSH 서버로 돌아가고, 오직 공개 키 인증만 지원함.

• 페어링하면 로컬 키가 생성돼서 PC의 표준 authorized_keys 파일에 저장됨.

• 릴레이 서버는 연결만 담당함 - 터미널 스트림을 읽거나, 기기를 추가하거나, 키를 가로채는 건 불가능함.

• FCM을 통한 푸시 알림은 AES-256-GCM으로 종단간 암호화됨 (P-256 키는 폰에만 저장됨), 그래서 전송 중에 알림 내용 털릴 일 없음.