moshterm

~ moshterm-hook

Companion

moshterm-hook은 에이전트가 사용하는 컴퓨터에서 실행되는 작은 프로그램입니다. 평범한 터미널이 에이전트가 기다리고 있음을 알도록 만들어 줍니다.

모바일 앱 받기

Android용 moshterm은 지금 Google Play에서 받을 수 있으며, iPhone 및 iPad용 앱은 출시 예정입니다. 터미널과 Companion 기능은 무료이며, moshterm Pro는 실시간 미리보기를 추가합니다.

App Store 출시 예정 Google Play에서 다운로드

추가되는 기능

  • 승인: 에이전트의 권한 요청이 휴대전화로 도착하고 응답이 다시 전달됩니다.
  • Inbox 및 알림: 어떤 세션에 응답이 필요한지, 무엇이 작업 중이고 완료되었는지 보여 줍니다.
  • 채팅 화면(Chat View): 컴퓨터의 에이전트 트랜스크립트를 읽어 대화 형태로 표시합니다.
  • Jump To와 tmux, Zellij, Herdr 세션 선택기.
  • 터미널이 열려 있는 폴더의 diff 확인과 파일 탐색.

Companion이 없어도 moshterm은 완전한 Mosh, Eternal Terminal, SSH 터미널입니다.

간편한 설치

앱에서 컴퓨터에 연결합니다. Companion이 설치되어 있지 않으면 moshterm이 그 연결을 통해 설치할지 묻습니다. 수락하면 나머지는 자동으로 처리됩니다. 이후 오래된 Companion도 연결 시 같은 방식으로 최신 상태로 유지합니다.

직접 설치

macOS, Linux 또는 WSL에서:

# ~/.local/bin에 설치하고 백그라운드 서비스를 시작합니다curl -fsSL https://mickmosh-relay.mick-fb5.workers.dev/install.sh | sh

시스템에 SHA-256 도구가 있으면 설치 스크립트가 공개된 체크섬과 내려받은 파일을 대조합니다. 그다음 에이전트용 훅을 추가합니다:

# moshterm 항목만 추가하며 기존 훅은 건드리지 않습니다moshterm-hook install

관리형 훅을 지원하는 에이전트: Claude Code, Codex, OpenCode, Cursor, Grok Build, Kimi Code, Hermes, Pi, OMP. moshterm-hook uninstall은 install이 추가한 항목만 제거합니다.

페어링

복사할 것이 없습니다. 휴대전화가 처음 SSH로 연결할 때 그 세션을 통해 Companion에서 토큰을 받아 오며, 그 뒤로도 SSH 연결을 통해 통신합니다. 주소를 입력하는 대신 QR 코드로 컴퓨터를 추가하려면 moshterm-hook pair --qr을 실행해 앱으로 스캔하면 됩니다.

설치 위치와 동작

  • 내 사용자 계정으로 실행되며 127.0.0.1에서만 대기합니다. 여러 계정이 있는 컴퓨터에서는 데이터를 보내기 전에 다른 사람의 Companion이 아닌 내 Companion인지 확인합니다.
  • 상태 파일은 ~/.moshterm/에 저장되며 본인만 읽을 수 있습니다.
  • macOS와 Linux의 ARM 및 x86용으로 빌드된 단일 정적 바이너리입니다.

호스트의 Mosh와 tmux

네트워크 전환을 견디는 세션에는 컴퓨터에 mosh-server가 필요하며, 연결이 끊겨도 세션을 유지하려면 멀티플렉서가 필요합니다. Eternal Terminal은 선택 사항입니다.

# macOSbrew install mosh tmux
# Debian, Ubuntu, WSLsudo apt install mosh tmux

문제가 생겼을 때

moshterm-hook doctor는 실행 중인 Companion이 인식하는 주소, 찾은 도구, 각 에이전트의 훅 상태, 페어링 여부를 출력합니다. SSH에서도 작동하므로 휴대전화에서 바로 실행할 수 있습니다.

여전히 해결되지 않으면 지원(영문) 페이지에 있는 주소로 문의해 주세요.