# Agent Bridge

- [소개](https://agent-bridge.pubdoc.dev/guide/introduction): Agent Bridge 가 무엇인지, 어떻게 동작하는지, 왜 쓰는지를 한 페이지로 정리해요.
- [시작하기](https://agent-bridge.pubdoc.dev/guide/getting-started): 돌고 있는 서버에 맥을 연결하고, 폰에서 첫 세션을 띄워 메시지를 주고받기까지의 단계예요.
- [지원 환경](https://agent-bridge.pubdoc.dev/guide/requirements): 호스트(맥), 브라우저, 서버에 필요한 운영체제·도구·버전을 표로 정리해요.
- [구성과 연결](https://agent-bridge.pubdoc.dev/guide/concepts/architecture): 서버, 연동 페이지, 에이전트, 조작 페이지가 무엇이고 어느 쪽이 어떤 연결을 여는지 설명해요.
- [보안 모델](https://agent-bridge.pubdoc.dev/guide/concepts/security): Agent Bridge 가 무엇을 믿고 무엇을 막는지, 서버·에이전트·업데이트·잠금·알림이 어떻게 지켜지는지 설명해요.
- [세션의 일생](https://agent-bridge.pubdoc.dev/guide/concepts/sessions): 세션이 뜨고, 일하고, 사람을 기다리고, 멈추는 과정과 에이전트가 그 상태를 알아내는 방법을 설명해요.
- [옮기기와 작업 폴더 싱크](https://agent-bridge.pubdoc.dev/guide/concepts/sync): 대화가 어디에 있는지, 무엇을 언제 싱크하는지, 세션을 다른 맥으로 옮길 때 무슨 일이 일어나는지 설명해요.
- [접근 관리와 운영 화면](https://agent-bridge.pubdoc.dev/guide/operate/admin): 운영자를 정하고, 설정의 운영 탭에서 계정 접근을 허용·거부·회수하고, 모든 사용자의 맥 상태와 모델 목록을 관리하는 절차예요.
- [끊기지 않는 배포](https://agent-bridge.pubdoc.dev/guide/operate/deploy): 새 서버 컨테이너를 먼저 띄우고 옛 서버가 상태와 요청을 넘겨주게 해서, 요청 실패 없이 Agent Bridge 서버를 새 버전으로 올리는 절차예요.
- [서버 올리기](https://agent-bridge.pubdoc.dev/guide/operate/self-host): Docker 로 Agent Bridge 서버를 올리고, GitHub 로그인과 HTTPS 리버스 프록시를 붙여 첫 맥을 연결하기까지의 절차예요.
- [에이전트 서명 키](https://agent-bridge.pubdoc.dev/guide/operate/signing): 포크한 서버의 맥들이 자동 업데이트를 받도록 에이전트 서명 키를 만들고, 에이전트를 고칠 때마다 서명하고, 키를 안전하게 바꾸는 절차예요.
- [문제 해결](https://agent-bridge.pubdoc.dev/guide/operate/troubleshooting): 맥이 연결되지 않거나 세션·옮기기·알림·음성·업데이트가 안 될 때, 증상별로 무엇을 확인하고 어떻게 고치는지 정리한 가이드예요.
- [맥의 대화 가져오기](https://agent-bridge.pubdoc.dev/guide/use/adopt): 맥의 터미널이나 다른 도구에서 시작한 Claude Code 대화를 골라 Agent Bridge 세션으로 이어 가는 방법이에요.
- [맥을 늘 연결해 두기](https://agent-bridge.pubdoc.dev/guide/use/always-on): 맥이 잠들거나 브라우저 탭이 닫혀도 세션이 끊기지 않게, 잠자기 막기·덮개를 닫아도 켜 두기·헤드리스 연동 모드를 켜는 방법이에요.
- [세션 옮기기](https://agent-bridge.pubdoc.dev/guide/use/move): 세션을 다른 맥으로 옮기는 절차, 옮길 수 없을 때의 이유와 할 일, 돌아가기 배너의 뜻을 다뤄요.
- [알림과 웹 푸시](https://agent-bridge.pubdoc.dev/guide/use/notifications): 확인 창이나 백그라운드 작업 소식을 알림 센터와 웹 푸시로 받는 방법, 폰에서 웹 푸시를 켜는 법을 다뤄요.
- [목록 정리와 잠금](https://agent-bridge.pubdoc.dev/guide/use/organize): 세션 목록을 그룹으로 묶고, 휴면과 가벼운 복제로 가볍게 유지하고, 비밀번호로 세션을 잠그는 방법이에요.
- [폰에서 세션 다루기](https://agent-bridge.pubdoc.dev/guide/use/sessions): 폰에서 새 세션을 띄우고, 글과 사진을 보내고, 권한 요청에 답하고, 세션을 멈추거나 설정을 바꾸는 방법이에요.
- [Slack 플러그인](https://agent-bridge.pubdoc.dev/guide/use/slack): Slack 앱을 만들어 Slack 플러그인을 켜고, 세션을 Slack 전용 채널의 스레드에서 이어 가는 방법이에요.
- [음성 입력](https://agent-bridge.pubdoc.dev/guide/use/voice): 맥에 whisper.cpp 와 모델을 두고, 세션 입력창의 마이크로 말해서 글을 보내는 방법이에요.
- [설치 스크립트와 에이전트 명령](https://agent-bridge.pubdoc.dev/reference/agent-cli): 맥에 에이전트를 까는 install.sh 와 node ~/.claude-bridge/agent.mjs 의 모든 명령, 옵션, 기본값, agent.json 에 저장되는 키를 정리한 표예요.
- [점검 항목](https://agent-bridge.pubdoc.dev/reference/checks): 에이전트가 맥에서 돌리는 점검 항목 전체와 각 항목의 문제·해결 방법, 세션 시작을 막는지, 점검이 도는 때를 정리한 표예요.
- [환경 변수](https://agent-bridge.pubdoc.dev/reference/env): Agent Bridge 서버와 맥 에이전트가 읽는 환경 변수 전체를 기본값, 필수 여부, 설명과 함께 정리한 표예요.
- [맥의 파일과 경로](https://agent-bridge.pubdoc.dev/reference/files): 에이전트가 맥에 쓰는 파일과 폴더(~/.claude-bridge, ~/.zeropty, launchd plist, sudoers 규칙, Claude Code 대화 기록)와 서버의 데이터 폴더(BRIDGE_DATA) 배치를 정리한 표예요.
- [용어집](https://agent-bridge.pubdoc.dev/reference/glossary): Agent Bridge 문서와 화면에서 쓰는 용어와 약어의 뜻, 그리고 자세히 다루는 페이지를 모은 용어집이에요.
- [레퍼런스 안내](https://agent-bridge.pubdoc.dev/reference/): Agent Bridge 레퍼런스가 다루는 것과 모든 레퍼런스 페이지의 목록, 가이드·변경 기록·전체 명세로 가는 길을 안내해요.
- [한도와 시간](https://agent-bridge.pubdoc.dev/reference/limits): Agent Bridge 가 쓰는 사용자에게 보이는 숫자 전부(명령 대기 시간, 끊김 표시, 확인 주기, 다시 알리기, 첨부·캐시·그룹·되살리기 한도, 보관 기간)를 단위와 함께 정리한 표예요.
- [플러그인 API](https://agent-bridge.pubdoc.dev/reference/plugin-api): Agent Bridge 서버 플러그인의 정의 모양(id, fields, start, choices, moveIn/moveOut)과 플러그인이 부를 수 있는 호스트 호출, 설정 API 를 정리한 표예요.
- [주소와 HTTP API](https://agent-bridge.pubdoc.dev/reference/routes): Agent Bridge 서버의 사용자 페이지 주소, 로그인 없이 열리는 경로, 로그인한 사용자의 HTTP API 묶음, 요청 규칙과 속도 제한, 맥 에이전트의 로컬 경로를 정리한 표예요.
- [세션 상태와 카드](https://agent-bridge.pubdoc.dev/reference/states): 세션 목록에 보이는 상태 이름, 세션과 호스트의 상태 전이, 카드 종류와 답하는 방법, 에이전트가 스스로 넘기는 확인 창을 정리한 표예요.
- [변경 기록](https://agent-bridge.pubdoc.dev/changelog): Agent Bridge 의 판별 변경 기록. 앱의 설정 → 변경 기록과 같은 목록이에요.