문서 · 주제
tmux 제어 모드
연결의 멀티플렉서를 tmux로 설정하면 Moshpit은 tmux의 -CC 제어 모드로 통신합니다(SSH에서는 직접, Mosh에서는 보조 -CC 제어 채널 병행). 분할된 ASCII 경계선을 휴대폰 화면에 억지로 우겨 넣는 대신 패널 하나를 전체 너비로 그리고, tmux 세션·창·패널을 네이티브 컨트롤로 바꿉니다.
몰래 세션을 만들지 않고 기존 세션에 연결
Section titled “몰래 세션을 만들지 않고 기존 세션에 연결”Moshpit은 호스트에서 이미 실행 중인 tmux 세션에 붙기만 하며, 사용자 모르게 새 세션을 만들지 않습니다.
- tmux에 세션이 없으면(
이 호스트에 tmux 세션이 없습니다) 기다리면서 새 세션을 표시해 사용자가 직접 시작 여부를 결정하게 합니다. - 호스트에
tmux가 설치되어 있지 않으면 이를 알리고 대신 일반 셸을 엽니다. - 이후 tmux 서버가 종료되거나 강제 종료되면(
세션 종료: 호스트의 tmux가 중지되었습니다.) 홈 화면에서 낡은 세션과 에이전트 행을 즉시 비우고 터미널에 새 세션을 제안합니다.
창, 패널 및 스크롤
Section titled “창, 패널 및 스크롤”상단 경로 표시(브레드크럼)의 각 구간을 탭해 빠른 목록을 여세요. 세션은 전체 세션 목록, 창은 창과 각 창의 패널 목록, 패널은 현재 창의 패널 목록을 보여 줍니다.
- 목록 끝의 새로 만들기를 탭해 새 세션을 만들거나 새 창을 열고 새 패널을 분할합니다.
- 행을 길게 누르면 창 이름 변경…, 창 종료…, 패널 종료… 메뉴가 나타납니다.
- 터미널을 위아래로 드래그하면 tmux 서버에 저장된 스크롤백을 터치 관성으로 읽을 수 있습니다. 마우스 인식 프로그램(
Claude Code,vim,less)이 실행 중이면 세로 드래그가 해당 앱의 마우스 휠 이벤트로 전달됩니다.
데스크톱과 세션 공유(tmux 3.8+)
Section titled “데스크톱과 세션 공유(tmux 3.8+)”- tmux 3.8+에서 독립된 활성 창: 호스트가 tmux
3.8이상을 실행 중이면 Moshpit은 모든 창과 패널을 공유하되 현재 활성 창만 따로 유지하는 그룹 세션으로 연결합니다. 휴대폰에서 창을 바꿔도 노트북 터미널은 보고 있던 창에 그대로 남습니다. - 여러 기기 간 창 크기: iPhone과 iPad 등 Moshpit 기기 두 대가 같은 창을 보고 있으면 마지막으로 터치한 기기가 격자 크기를 소유합니다. 다른 기기에는
이 창은 … 크기로 맞춰져 있습니다와 함께 이 기기 크기 사용 버튼이 나타나 한 번 탭해 크기를 넘겨받을 수 있습니다. 앱을 떠나면 크기 고정은 자동으로 해제됩니다.
사용자 설정 tmux 경로
Section titled “사용자 설정 tmux 경로”Moshpit은 표준 로그인 PATH와 /opt/homebrew/bin, /usr/local/bin, ~/.local/bin을 확인합니다. tmux 바이너리가 다른 곳에 있다면 연결 편집 › 고급 › 사용자 설정 tmux 경로에 전체 경로를 입력하세요(예: /home/dev/bin/tmux).