콘텐츠로 이동
moshpit
KO

문서 · 주제

호스트 설정

**호스트 설정(Set up a host)**은 코딩 에이전트의 수명 주기 훅을 Moshpit에 연결해, 휴대폰이 각 에이전트의 상태를 확인하고 에이전트가 기다리거나 턴을 마쳤을 때 암호화 푸시를 받을 수 있게 합니다.

Moshpit은 호스트의 어떤 파일도 몰래 바꾸지 않습니다. 첫 연결 시 설치 전에 먼저 확인을 요청하며, 언제든 설정을 점검·테스트·복구·제거할 수 있습니다.

  1. Moshpit에서 호스트에 연결합니다.
  2. 설정 › 호스트 설정을 열고 연결된 호스트를 탭합니다.
  3. 에이전트 상태에서 에이전트를 선택해 설치(또는 업데이트 / 재설치)를 탭합니다. 열린 tmux 패널이 있는 상태에서 아래 테스트 행을 탭하면 스크립트가 정상 실행되는지 검증할 수 있습니다.
  4. 푸시에서 페어링(또는 다시 페어링)을 탭한 뒤, Moshpit을 화면에 띄워 둔 채 테스트 알림 보내기를 탭해 왕복 전달을 확인합니다.

푸시에는 호스트에 openssl과 curl이 필요합니다. jq를 추가로 설치해 두면 완료 알림에 에이전트가 답변한 프롬프트 내용까지 함께 표시됩니다.

모든 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는 사용자가 호스트에서 승인하기 전까지 새로 추가된 훅을 실행하지 않습니다.

  1. 호스트 셸에서 codex를 실행합니다.
  2. /hooks를 입력합니다.
  3. Moshpit 항목 4개를 신뢰함으로 표시합니다.

이 단계를 마치기 전까지는 Codex가 tmux에 상태를 기록하거나 푸시를 보내지 않습니다.

호스트에 연결된 상태에서 설정 › 호스트 설정을 여세요.

  • 특정 에이전트만 제거: 에이전트 상태에서 해당 에이전트를 선택하고 제거를 탭합니다.
  • 이 휴대폰의 푸시만 중지: 푸시 아래에서 페어링 해제를 탭하면 이 휴대폰의 페어링 파일이 삭제되고 해당 호스트의 푸시가 중단됩니다.
  • 모두 제거: 이 호스트에서 Moshpit 제거를 탭하고 확인하세요. 모든 에이전트 설정에서 Moshpit 훅 항목만 깔끔히 빼내고(나머지 설정은 유지), 이 휴대폰의 페어링을 지우며, 페어링된 다른 휴대폰이 없으면 ~/.moshpit 디렉토리도 삭제합니다.