jacewiki 🌳

crossbell/대화

최근 수정 시각: 2026-08-28 22:20:10

분류: | 가이드 | 메신저

🪦 은퇴한 기능 — 2026-08-03 축소 개편으로 메신저 계층(실시간 허브·connector·오프라인 큐·파일 전송)이 crossbell에서 제거됐다. 지금 에이전트와의 대화는 warren의 pane 입력과 대화 리더가 맡는다. 아래는 그 시절의 기록이다.

1. 무엇을 하나

대화 탭은 브라우저와 각 머신의 에이전트 세션을 실시간으로 잇는다. 메시지와 파일을 양방향 전송하고, 에이전트의 처리 중 상태·온라인 상태·권한 요청을 같은 대화창에 표시한다. 세션이 오프라인이어도 메시지는 D1 큐에 남았다가 재접속 후 전달된다.

2. 대화 시작하기

  1. crossbell에 Cloudflare Access로 로그인한다.
  2. 상단 메신저 탭을 고른다.
  3. 에이전트 검색창에서 이름이나 머신명을 찾거나 최근 대화 목록에서 행을 누른다.
  4. 하단 입력창에 메시지를 쓰고 전송 버튼을 누른다. PC에서는 한글 IME 조합이 끝난 상태에서 Enter로 전송하고 Shift+Enter로 줄을 바꾼다.

데스크톱은 왼쪽 목록과 오른쪽 대화의 2열 화면이고, 모바일은 목록 → 대화의 스택 내비게이션이다.

3. 메시지와 파일

에이전트 응답은 GFM 마크다운과 코드블록으로 렌더되며 코드 복사 버튼을 제공한다. 사용자 메시지는 입력한 원문 그대로 표시된다. 날짜 구분선과 시각, 전송 확인 또는 큐 대기 상태가 말풍선 아래에 나타난다.

파일을 보내려면 입력창 왼쪽 + 버튼을 누르고 파일을 선택한다. 이미지는 말풍선 안에서 미리 보고, 일반 파일은 이름과 다운로드 링크로 나타난다. 서버와 connector는 R2 첨부를 사용하며 파일 한도는 코드상 25MB다.

4. 오프라인과 처리 중 상태

대화 헤더는 다음 상태를 구분한다.

오프라인 에이전트에게 보낸 메시지는 말풍선에 큐 대기 ⏳가 붙는다. 에이전트가 다시 attach하면 ack 기반으로 재전송된다. 헤더에 깨우기가 보이면 crossbell/멀티머신의 원격 wake를 실행할 수 있다.

5. 권한 요청

Claude Code가 도구 실행 권한을 요청하면 대화에 권한 카드가 나타난다. 카드의 요청 도구와 내용을 읽고 승인 또는 거부한다. 10분 동안 응답하지 않은 요청은 자동 거부된다.

권한 카드는 단순 알림이 아니라 원격 실행 승인이다. 명령·파일 경로·외부 영향이 불명확하면 승인하지 않는다.

6. 읽음과 알림

앱 진입 시 모든 에이전트의 최근 메시지를 백필해 목록 미리보기와 안읽음 배지를 만든다. 한 기기에서 읽은 위치는 서버에 저장되고 다른 브라우저에도 앞으로만 동기화된다.

설정의 푸시 알림 받기에서 이 브라우저를 구독하고 범위를 고를 수 있다.

7. 팁과 주의

8. 관련 문서