데스크톱 앱은 왜 필요한가요?

데스크톱 앱이 하는 일

휴대폰의 Agent Terminal은 명령을 실행하지 않습니다. 모든 셸은 Windows PC나 Mac에서 실행되며, 데스크톱 앱은 다음 일을 맡습니다:

• 터미널을 계속 실행합니다. 호스트 프로세스 안에서 돌기 때문에, 앱을 닫거나 휴대폰 신호가 끊겨도 터미널이 끝나지 않습니다.
• QR 코드로 휴대폰을 페어링합니다.
• 휴대폰의 접속을 받아 줍니다. 모든 연결은 데스크톱 앱의 단일 SSH 게이트웨이를 통해서만 들어오며, 이 게이트웨이는 공개 키만 받아들입니다.
• 집 밖에서도 휴대폰과 연결해 줍니다. 사설 네트워크에서도 마찬가지입니다.

macOS에서

데스크톱 앱을 설치하고, 휴대폰을 페어링하고, 둘 중 어디서든 터미널을 여세요. 설정에서 Start the host when you log in(로그인 시 호스트 시작)을 켜 두면, 앱을 열어 두지 않아도 휴대폰이 터미널에 닿을 수 있고, 호스트가 예기치 않게 멈추면 다시 시작됩니다.

Mac에서는 이미 열려 있는 셸도 옮길 수 있습니다. Move shells from your terminal app to Agent Terminal(터미널 앱의 셸을 Agent Terminal로 옮기기)을 켠 다음, 그 뒤에 연 Terminal, iTerm2 또는 Ghostty 창에서 Ctrl+\를 누른 다음 s를 누르면, 그 셸이 Agent Terminal로 옮겨져 휴대폰이 거기에 닿을 수 있습니다.

Windows에서

Windows에서는 한 앱이 실행 중인 터미널을 다른 앱에 넘길 수 없습니다. 콘솔은 끝날 때까지 시작된 창에 남아 있습니다. Windows가 콘솔을 터미널 앱에 넘기는 것은 시작하는 순간뿐입니다.

그래서 설정 하나를 권장합니다. 데스크톱 앱에서 Settings → General(설정 → 일반)을 열고, Set as default terminal app 옆의 Apply(적용)를 누르세요. 그 뒤로는 시작 메뉴, 바로 가기 또는 실행 창에서 여는 명령 프롬프트와 PowerShell 창이 대신 Agent Terminal에서 열리며, 휴대폰이 거기에 닿을 수 있습니다. 되돌리려면 같은 행의 Undo(실행 취소)를 누르세요.

이 설정을 끈 채로 두면 다음과 같습니다:

• Agent Terminal 밖에서 연 터미널에는 휴대폰이 닿을 수 없습니다.
• PC에서든 휴대폰에서든 Agent Terminal로 연 터미널에는 닿을 수 있습니다.

어느 쪽이든, 설정을 켜기 전에 이미 열려 있던 터미널은 원래 자리에 그대로 남습니다.