문서 · 주제
호스트 설정
**호스트 설정(Set up a host)**은 코딩 에이전트의 수명 주기 훅을 Moshpit에 연결해, 휴대폰이 각 에이전트의 상태를 확인하고 에이전트가 기다리거나 턴을 마쳤을 때 암호화 푸시를 받을 수 있게 합니다.
호스트 설정 실행하기
Section titled “호스트 설정 실행하기”Moshpit은 호스트의 어떤 파일도 몰래 바꾸지 않습니다. 첫 연결 시 설치 전에 먼저 확인을 요청하며, 언제든 설정을 점검·테스트·복구·제거할 수 있습니다.
- Moshpit에서 호스트에 연결합니다.
- 설정 › 호스트 설정을 열고 연결된 호스트를 탭합니다.
- 에이전트 상태에서 에이전트를 선택해 설치(또는 업데이트 / 재설치)를 탭합니다. 열린 tmux 패널이 있는 상태에서 아래 테스트 행을 탭하면 스크립트가 정상 실행되는지 검증할 수 있습니다.
- 푸시에서 페어링(또는 다시 페어링)을 탭한 뒤, Moshpit을 화면에 띄워 둔 채 테스트 알림 보내기를 탭해 왕복 전달을 확인합니다.
푸시에는 호스트에 openssl과 curl이 필요합니다. jq를 추가로 설치해 두면 완료 알림에 에이전트가 답변한 프롬프트 내용까지 함께 표시됩니다.
호스트에 기록되는 파일
Section titled “호스트에 기록되는 파일”모든 Moshpit 파일은 ~/.moshpit 아래에 저장되며, 사용자가 다른 에이전트 설치를 명시적으로 확인하지 않는 한 해당 호스트에서 발견된 에이전트에만 훅 항목을 추가합니다.
| 경로 | 용도 |
|---|---|
~/.moshpit/moshpit-stamp.sh |
에이전트 훅이 호출하는 스크립트. tmux 패널에 @moshpit_* 옵션을 기록하고 “대기 중”·“완료” 시 푸시를 호출합니다. |
~/.moshpit/moshpit-push.sh |
호스트에서 상태 페이로드를 암호화해 암호문을 푸시 릴레이로 전송합니다. |
~/.moshpit/manifest.json |
설치된 파일의 SHA-256 해시 목록. 스크립트가 오래되었는지 판별할 때 사용합니다. |
~/.moshpit/push.d/<connection-id>.conf |
이 휴대폰의 256비트 페어링 비밀키와 전송 토큰(0600 권한으로 저장). |
<config>.moshpit.orig |
Moshpit이 에이전트 설정 파일을 처음 수정하기 전에 저장하는 1회성 백업. |
호스트에 설치된 에이전트에 따라 ~/.claude/settings.json, ~/.codex/config.toml, ~/.gemini/settings.json, ~/.qwen/settings.json, ~/.qoder/settings.json, ~/.factory/settings.json(또는 ~/.factory/hooks.json), ~/.codebuddy/settings.json에 훅 항목을 병합합니다. 기존 설정 내용은 그대로 보존됩니다.
Codex에서 훅 신뢰하기
Section titled “Codex에서 훅 신뢰하기”Codex는 사용자가 호스트에서 승인하기 전까지 새로 추가된 훅을 실행하지 않습니다.
- 호스트 셸에서
codex를 실행합니다. /hooks를 입력합니다.- Moshpit 항목 4개를 신뢰함으로 표시합니다.
이 단계를 마치기 전까지는 Codex가 tmux에 상태를 기록하거나 푸시를 보내지 않습니다.
되돌리기 또는 제거
Section titled “되돌리기 또는 제거”호스트에 연결된 상태에서 설정 › 호스트 설정을 여세요.
- 특정 에이전트만 제거: 에이전트 상태에서 해당 에이전트를 선택하고 제거를 탭합니다.
- 이 휴대폰의 푸시만 중지: 푸시 아래에서 페어링 해제를 탭하면 이 휴대폰의 페어링 파일이 삭제되고 해당 호스트의 푸시가 중단됩니다.
- 모두 제거: 이 호스트에서 Moshpit 제거를 탭하고 확인하세요. 모든 에이전트 설정에서 Moshpit 훅 항목만 깔끔히 빼내고(나머지 설정은 유지), 이 휴대폰의 페어링을 지우며, 페어링된 다른 휴대폰이 없으면
~/.moshpit디렉토리도 삭제합니다.