PeerBridge MCP

English | 繁體中文 | 简体中文

Codex, Claude Code, Grok, Kimi, DeepSeek, Gemini, 로컬 모델 및 기타 MCP 또는 OpenAI 호환 에이전트를 하나의 감사 가능한 AI 팀으로 통합합니다.

PeerBridge는 공식 클라이언트, 릴레이 서비스, 호환 API 및 로컬 모델을 연결하여 팀을 하나의 제공업체에 고정하지 않습니다. 모든 에이전트에게 동등한 자리, 공유 승인된 메모리, 제한된 병렬 토론, 작업 소유권, 상호 평가, 교차 에이전트 감사, 그리고 작업이 계속 표시되는 인간 제어 방을 제공합니다. 실시간 토큰 대시보드는 제공업체 및 모델별 사용량을 보여줍니다. PeerBridge는 로컬 SQLite에서 실행되며, 제공업체 자격 증명을 채팅 및 프로젝트 기록에서 제외하고, 메시지, 결정, 증거, 점수, 리뷰 및 핸드오프의 SHA 연결 기록을 보존합니다.

인간 또는 에이전트 메시지가 방을 깨울 수 있으며, 협업은 합의, 차단, 정체 또는 명시적 한계에 도달하면 중단되고, 운영자는 언제든지 개입할 수 있습니다.

상태: 알파. 조정 및 감사 코어는 테스트되었지만, 공개 API 및 데이터베이스 스키마는 1.0 이전에 변경될 수 있습니다.

운영 연속성 및 상업화는 명시적인 설계 경계입니다. 메모리 및 장기 실행 작업 및 오픈 코어 경계를 참조하세요. 원격/모바일 모듈은 실험적이며 기본적으로 꺼져 있습니다. 로드맵 항목은 기능 주장이 아닙니다.

Why

하나의 저장소에 대해 두 개의 코딩 에이전트를 실행하면 예측 가능한 실패 모드가 발생합니다:

• 두 에이전트가 동일한 파일을 편집합니다;

• 한 에이전트가 피어가 온라인이라고 가정하지만 실제로는 그렇지 않습니다;

• 채팅 메시지가 소비자별로가 아니라 전역적으로 손실되거나 확인됩니다;

• 리뷰가 실제로 테스트된 파일이 아닌 오래된 파일을 승인합니다;

• 인간이 작업을 소유한 사람이나 완료로 표시된 이유를 볼 수 없습니다.

PeerBridge는 어느 에이전트도 보스로 만들지 않고 이러한 조정 실패를 해결합니다. 하나의 작업에는 하나의 작성자 임대가 있으며, 피어는 서로를 검토할 수 있고, 인간이 개입할 수 있습니다.

Related MCP server: JustClone Coordination MCP Server

Architecture

flowchart LR
    H["Human operator"] --> M["Pixel control room"]
    C["Codex / Claude Code"] --> S1["PeerBridge stdio process"]
    A["Grok / Kimi / DeepSeek / Gemini / local Agents"] --> S2["PeerBridge stdio process"]
    M --> S3["PeerBridge stdio process"]
    R["Private mobile UI"] -->|"Tailnet HTTPS"| T["Tailscale Serve"]
    T -->|"loopback only"| S4["Human MCP message gateway"]
    S1 --> DB[("Shared SQLite store")]
    S2 --> DB
    S3 --> DB
    S4 --> DB
    DB --> L["SHA-linked audit events"]
    DB --> W["Mailbox, leases, reviews, proofs"]

각 MCP 클라이언트는 고유한 --agent-id로 자체 stdio 서버 프로세스를 시작합니다. 이러한 프로세스는 하나의 프로젝트 로컬 .peerbridge/peerbridge.sqlite3 데이터베이스를 통해 조정됩니다. SQLite WAL 모드와 BEGIN IMMEDIATE 트랜잭션은 상태 변경을 직렬화합니다.

Features

• 만료 시간이 있는 에이전트별 존재 여부, 영구 온라인 플래그가 아닙니다.

• 클라이언트, 제공업체 경로 및 선택된 모델에 대한 감사된 런타임 ID 레이블.

• SHA 바인딩된 직접 및 브로드캐스트 메시지.

• 재사용 가능한 방 범위 좌석이 있는 영구 글로벌 에이전트 라이브러리; 에이전트를 한 방에 추가해도 라이브러리나 다른 방에서 제거되지 않습니다.

• 독립적인 멤버십 세션, 받은 편지함 커서, 응답 경계 및 방 바인딩 협업 영수증이 있는 내구성 있는 다중 방 대화.

• 제공업체 중립 메모리 원장: 소유자 전용 비공개, 멤버십 바인딩 방, 인간 승인 프로젝트 기록, 각각 명시적 소스 증거에 SHA 바인딩됨.

• 소비자별 영수증 및 연속 내구성 커서.

• 만료 및 복구가 있는 기능 토큰 작업 임대.

• 결정적 읽기/쓰기 경로 중복 검사.

• solo_allowed, two_party_required, presence_aware 및 N-피어 쿼럼 정책.

• 소스 바인딩 피어 리뷰 요청 및 동등 피어 평결.

• 정확히 검토된 소스에 연결된 상호 에이전트 점수 및 교차 에이전트 감사 추적.

• 제공업체/모델별 분석 및 입력, 출력, 캐시 쓰기, 캐시 읽기 추세가 있는 실시간 토큰 사용 대시보드.

• 공식 CLI를 통한 원클릭 CC Switch 제공업체/모델 동기화, 자격 증명은 사용자의 기존 CC Switch 설치에 유지됩니다.

• 작업 완료 전 실시간 파일 재해시.

• 자동으로 적용되지 않는 격리된 계획 및 패치 초안.

• 검증기가 있는 추가 전용 범위별 SHA-256 이벤트 체인.

• 인간 MCP 메시지 작성을 위한 픽셀 스타일 로컬 제어실.

• 조정 코어는 Python 표준 라이브러리 외에 런타임 종속성이 없습니다. 선택적 암호화 피드백은 feedback 추가 기능(cryptography)을 사용합니다.

• 이중 시대 MCP 지원: 레거시 초기화 및 2026-07-28 검색 모델.

• 루프백 및 Tailscale Serve를 통한 선택적 제로 렌탈 개인 모바일 제어.

• 제한된 방 기록 페이지 매김, 활성 탭 렌더링 및 선택적 제공업체 실행기를 위한 싱글톤 저메모리 사서함 감독자.

Quickstart

Windows portable app

GitHub Alpha 릴리스에서 PeerBridgeControlRoom-0.1.0a6-windows-x64-portable.zip을 다운로드하고, 전체 ZIP을 쓰기 가능한 폴더에 추출한 후 Launch PeerBridge.cmd를 더블 클릭하세요. 휴대용 앱은 %LOCALAPPDATA%\PeerBridge\workspace 아래에 로컬 작업 공간을 생성합니다. 제공업체 자격 증명이나 개인 런타임 데이터는 포함되지 않습니다.

이 알파 실행 파일은 코드 서명되지 않았으므로 Windows SmartScreen에서 게시자를 검토하도록 요청할 수 있습니다. 열기 전에 릴리스 SHA-256을 확인하세요. PeerBridge는 자동 설치 프로그램을 제공하지 않으며 기존 Python 환경을 수정하지 않습니다.

Install from source

요구 사항: Python 3.11 이상.

git clone https://github.com/hoylon/peerbridge-mcp.git
cd peerbridge-mcp
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -e ".[dev]"
peerbridge init --project-root . --scope demo
peerbridge doctor --project-root . --scope demo

서버를 수동으로 실행:

peerbridge serve --project-root . --agent-id codex-main --scope demo

하나의 클라이언트가 여러 공식 또는 릴레이 지원 모델을 선택할 수 있는 경우, 자격 증명을 노출하지 않고 경로를 기록합니다:

peerbridge serve --project-root . --agent-id grok-relay-reviewer --scope demo `
  --client-name relay-coding-client `
  --provider-id relay:grok-official-channel `
  --model-id grok

agent-id는 논리적 작업자를 식별합니다. client-name은 MCP 지원 애플리케이션 또는 어댑터를 식별합니다. provider-id는 운영자가 제공한 비밀 아닌 경로 레이블이며, model-id는 선택된 모델을 식별합니다. Grok 또는 DeepSeek 공식 웹사이트와 릴레이 경로는 동일한 모델 제품군을 노출하더라도 별도의 ID입니다.

직접 OpenAI 호환 엔드포인트는 CC Switch가 필요하지 않습니다. 안전한 연결 페이지에서 API 기본 URL과 API 키를 Windows 자격 증명 관리자에 저장한 다음, 논리적 에이전트당 하나의 경로를 등록하세요. API 키는 SQLite나 MCP 메시지에 절대 입력되지 않습니다. 일부 릴레이는 요청된 모델 ID 하나를 수락하지만 응답에서 안정적인 배포 별칭을 보고합니다. 이 경우 EXPECTED RESPONSE MODEL을 명시적으로 설정하세요. 예를 들어, 경로가 grok-4.6을 요청하면서 응답이 grok-4.6-build를 보고하도록 요구할 수 있습니다. 구성되지 않았거나 변경되는 별칭은 요청된 모델로 조용히 처리되지 않고 실패로 종료됩니다.

서버는 stdin/stdout을 통해 개행으로 구분된 JSON-RPC를 사용합니다. 일반적으로 MCP 클라이언트가 자동으로 시작하므로, 수동으로 시작된 서버가 입력을 기다리는 것은 예상된 동작입니다.

Connect clients

각 클라이언트가 동일한 설치 환경과 공유 데이터베이스를 시작하도록 절대 Python 실행 파일 경로를 사용하세요.

Codex

codex mcp add peerbridge -- C:\path\to\peerbridge-mcp\.venv\Scripts\python.exe `
  -m peerbridge_mcp serve --project-root C:\path\to\your-project `
  --agent-id codex-main --scope your-project

Claude Code

claude mcp add --scope project --transport stdio peerbridge -- `
  C:\path\to\peerbridge-mcp\.venv\Scripts\python.exe `
  -m peerbridge_mcp serve --project-root C:\path\to\your-project `
  --agent-id claude-code --scope your-project

두 클라이언트가 공유 프로젝트 구성을 작성하는 경우 다른 MCP 서버 항목 이름을 사용하세요(예: peerbridge-codex 및 peerbridge-claude). TOML, JSON, Linux 및 macOS 예제는 클라이언트 구성을 참조하세요. 동일한 stdio 서버를 Kimi Code CLI에 등록할 수 있습니다. 다른 제공업체는 별도의 API 기반 실행기가 필요할 수 있습니다. 에이전트 통합 경계를 참조하세요.

PeerBridge는 에이전트 이름에서 추론하는 대신 각 바인딩된 방 좌석의 유효 기능을 보고합니다:

• MCP NATIVE: 실제 MCP 지원 클라이언트 또는 터미널이 세션을 소유하고 PeerBridge 서버를 직접 호출할 수 있습니다.

• MCP TOOL: API 기반 모델이 PeerBridge의 제한된 허용 목록 MCP 도구 루프 내에 있습니다. 도구를 사용할 수 있지만 네이티브 클라이언트 세션으로 표시되지 않습니다.

• INFERENCE: 경로가 제한된 모델 답변을 반환할 수 있지만 PeerBridge 도구를 호출할 수 없습니다. 웹 채팅 탭과 일회성 CLI 폴백이 여기에 속합니다.

MCP를 구현하는 다른 클라이언트나 터미널은 클라이언트 구성에 표시된 동일한 stdio 명령을 사용할 수 있습니다. 구성된 경로는 해당 클라이언트가 실제로 실행 중이고 권한이 부여될 때까지 활성으로 간주되지 않습니다.

공식 클라이언트 참조:

• Codex MCP 구성

• Claude Code MCP 구성

• Kimi Code CLI

Pixel control room

peerbridge monitor --project-root C:\path\to\your-project --scope your-project

모니터는 메시지, 작업 소유권, 피어 리뷰, 증명 기록 및 이벤트 로그를 표시합니다. 작성기는 에이전트와 동일한 MCP stdio 경로를 통해 인간 메시지를 보내므로 인간 개입도 동일한 해시와 감사 추적을 받습니다.

에이전트는 영구적인 글로벌 에이전트 라이브러리에 있습니다. 에이전트를 방으로 끌어오거나 추가하면 방 범위 좌석이 생성됩니다. 글로벌 ID를 이동하거나 소모하지 않습니다. 따라서 동일한 에이전트가 여러 방에 동시에 참여할 수 있습니다. 모든 좌석에는 독립적인 room_session_id, 요청된 경로 및 방 커서가 있습니다. 좌석을 제거하면 해당 방의 향후 전달이 중단되지만 메시지 및 감사 기록은 유지됩니다. 컨텍스트는 방 간에 자동으로 복사되지 않습니다. 운영자가 컨텍스트를 공유하려면 명시적이고 감사된 요약 메시지가 필요합니다.

각 사용자 정의 방에는 명시적인 자동화 정책이 있습니다. Off는 모델을 깨우지 않고 기록을 저장합니다. One round는 모든 라우팅된 에이전트 좌석에 정확히 한 번씩 병렬로 요청합니다. Bounded discussion은 모든 현재 디스패치가 종료된 후에만 병렬 라운드를 진행합니다. 응답은 CONTINUE, CONSENSUS 또는 BLOCKED로 끝납니다. 코디네이터는 합의, 차단, 정체, 라운드 제한 또는 메시지 예산에 도달하면 중단됩니다. 방 막대를 통해 인간은 진행 중인 라운드를 일시 중지 및 재개하거나, 자동 중지 조건 후에 제한된 토론을 계속하거나, 명시적으로 중지할 수 있습니다.

응답은 통제되지 않은 응답 연쇄를 생성하지 않습니다. 코디네이터가 생성한 프롬프트만 디스패치 가능하며, 라운드 진행은 멱등적이며, 각 범위에는 하나의 감독자 작성자 잠금이 있습니다. 새 방 게시물을 시작하면 이전 열린 토론이 중지되지만 기록과 중지 이유는 유지됩니다.

데스크톱 작성기는 최대 5개의 명시적으로 선택된 PNG/JPEG/GIF/WebP 또는 UTF-8 텍스트/Markdown/CSV/JSON/로그 파일(각 8MiB, 총 16MiB)을 첨부할 수 있습니다. PeerBridge는 선언된 유형을 검증하고, 자격 증명 같은 텍스트를 거부하며, 각 파일을 무시된 로컬 .peerbridge-artifacts/chat/ 저장소에 SHA-256 이름으로 복사하고, 해당 상대 콘텐츠 주소 경로만 메시지에 바인딩합니다. 원래 절대 경로와 파일 이름은 SQLite에 입력되지 않습니다. 초기 팬아웃/토론 프롬프트는 바인딩을 한 번 받습니다. 이후 라운드는 중복하지 않습니다. 첨부 파일을 전송한다고 해서 선택한 제공업체가 이미지를 해석할 수 있다는 증명이 되지 않으므로, 지원되지 않는 경로는 이를 감사 가능한 파일 참조로 처리해야 합니다.

공유 메모리 페이지는 채팅과 별도로 명시적인 메모리 기록을 표시합니다. PeerBridge는 숨겨진 사고 사슬, 제공업체 측 대화 상태 또는 자격 증명을 추출하거나 동기화하지 않습니다. 에이전트는 자체 비공개 스크래치 요약을 작성할 수 있고, 활성 방 구성원은 방 메모리를 읽을 수 있으며, human-operator만 프로젝트 메모리를 게시하거나 취소할 수 있습니다. 프로젝트 승격에는 SHA 바인딩 소스 메시지, 상위 메모리 또는 프로젝트 아티팩트가 필요합니다. 취소는 원래 기록을 보존하고 기록을 삭제하는 대신 새 감사 영수증을 추가합니다.

API 기반 OpenAI 호환 실행기는 기본적으로 읽기 전용 list_memories 및 read_memory 도구만 받습니다. 따라서 Codex, Claude Code, Grok, Kimi, DeepSeek 또는 로컬 모델과 동일한 승인된 사실을 사용할 수 있으며 프로젝트 전체 메모리를 게시할 권한은 없습니다. 모든 방은 동일한 글로벌 에이전트가 여러 방에 좌석을 가지고 있더라도 독립적인 모델 세션과 커서를 유지합니다.

Private mobile control

선택적 실험적 원격 페이지는 Tailscale Serve를 통해 의도적으로 좁은 인간 인터페이스를 노출합니다. 백엔드는 127.0.0.1에만 바인딩됩니다. tailnet 프록시가 인증된 사용자 ID를 제공합니다. 범위 제한 관찰 및 감사된 인간 MCP 메시지를 지원하며, 셸 실행이나 파일 변경은 지원하지 않습니다.

.\scripts\launch_remote_control.cmd -Port 8765 -Scope your-project

보안 경계, 테스트, 전화 설정 및 공개 Tailscale Funnel 노출에 대한 명시적 금지는 개인 원격 및 모바일 제어를 참조하세요.

제품 상태 및 옵트인 메트릭

PeerBridge는 호스팅 서비스, 결제 흐름 또는 상용 권한 제공자를 활성화하지 않고 기계가 읽을 수 있는 기능 경계를 노출합니다:

peerbridge product --project-root . status
peerbridge product --project-root . status --capability remote.experimental.self_hosted

로컬 분석 후크는 기본적으로 꺼져 있습니다. 명시적인 옵트인 없이는 설치 ID를 생성하거나, 이벤트를 대기열에 추가하거나, 네트워크 엔드포인트에 접속하지 않습니다. 현재 알파 버전에는 분석 발신자가 전혀 없습니다. 활성화된 데이터는 무작위로 재설정 가능한 설치 ID와 함께 UTC 일 단위 집계 카운터로 로컬 시스템에 남아 있습니다.

peerbridge analytics --project-root . status
peerbridge analytics --project-root . enable
peerbridge analytics --project-root . export
peerbridge analytics --project-root . disable

GitHub 릴리스 자산 download_count는 파일 다운로드를 측정하며, 고유 사용자를 측정하지 않습니다. 실제 DAU/WAU/MAU 추정에는 향후 투명 수집기와 명시적 앱 옵트인이 필요하며, 사람이 아닌 활성 설치로 설명되어야 합니다. 프롬프트, 메시지 본문, API 키, 모델 출력, 파일 이름/경로, 프로젝트 이름, 계정 ID, IP 주소 및 임의 메타데이터는 공개 이벤트 스키마에서 제외됩니다. 텔레메트리 및 출시 지표와 실험적 원격/상용 후크를 참조하세요.

공지는 분석과 독립적입니다. 패키지된 알파 버전은 업데이트 확인 없이 긴급 공지가 표시될 수 있도록 기본적으로 읽기 전용 HTTPS 공지 연결을 활성화합니다. 각 요청은 선택된 UI 로케일, 로케일별 공지 커서, 고정된 비식별 PeerBridge 공지 클라이언트 사용자 에이전트를 전송합니다. 일반 네트워크 인프라에서도 소스 IP 주소를 관찰할 수 있습니다. 설치 ID, 자격 증명, 프로젝트 경로, 메시지 내용 또는 모델 출력을 전송하지 않습니다. 공지 페이지는 별도의 네트워크 스위치를 제공합니다. 끄면 공지 요청이 중단되지만, 제한된 로컬 캐시는 읽을 수 있는 상태로 유지됩니다. 팝업 알림은 자체 독립적인 기본 설정이 있습니다. 저장된 기본 설정 파일을 읽을 수 없는 경우, 사용자가 새 기본 설정을 명시적으로 저장할 때까지 네트워크 폴링과 팝업 모두 실패-종료(fail closed)됩니다.

피드백은 HTTPS를 통해 비공개로 제출됩니다. 일반적인 보고 메타데이터, 사용자가 선택한 진단 정보, 연락처 세부 정보 및 첨부 파일은 전송 중에 보호되지만, 지원 번들 내에서는 종단간 암호화되지 않습니다. 사용자가 명시적으로 포함하도록 선택한 선택적 자격 증명만 고정된 유지 관리자 지원 공개 키에 로컬로 암호화된 후 업로드됩니다. 피드백 개인정보 보호를 참조하세요.

제어실은 지속되는 zh-Hant / zh-Hans / 영어 로케일 기반, 재생 가능한 첫 실행 튜토리얼, 명시적인 읽기 전용 업데이트 확인을 제공합니다. 알파 설치 시 최신 GitHub 릴리스를 보고합니다. 향후 Stable 채널은 Stable 릴리스 트랙만 따릅니다. 검사기는 코드를 다운로드하거나 설치하지 않습니다. 서명된 원클릭 업데이트 및 롤백은 향후 작업으로 남아 있습니다.

안전 연결 페이지는 두 가지 로컬 온보딩 경로를 지원합니다:

• 개인 HTTPS 엔드포인트와 API 키를 입력합니다. PeerBridge는 현재 Windows 사용자의 자격 증명 관리자에 저장하고, MCP를 통해 수정된 식별자와 SHA-256 지문만 기록합니다.

• 공식 CC Switch CLI를 통해 기존 Claude, Codex, Gemini, OpenCode, Hermes 또는 OpenClaw 제공자를 검색하고, CC Switch에 이미 저장된 자격 증명을 사용하여 모델 ID를 가져오고, PeerBridge 경로를 등록하며, 명시적인 사람 확인 후에만 전환합니다.

호스트 전용 OpenAI 호환 URL의 경우, PeerBridge는 기존 /v1 API 베이스를 추가합니다. 제공자가 명시적인 호환성 경로를 게시하는 경우, 해당 전체 베이스 경로를 입력하십시오. PeerBridge는 이를 유지합니다. 이는 Gemini의 /v1beta/openai/ 호환성 베이스와 같은 엔드포인트를 제공자별 코드 없이 지원합니다.

PeerBridge는 원시 API 키나 전체 개인 엔드포인트를 MCP 메시지, SQLite, 감사 이벤트, 영수증, 로그, 명령줄 인수, 딥링크, Git 또는 텔레메트리에 넣지 않습니다. CC Switch 데이터베이스를 읽거나 CC Switch 구성을 내보내지 않습니다. 자동 CC Switch 제공자 생성은 의도적으로 비활성화되어 있습니다. 공개 딥링크/가져오기 계약이 운영 체제 비밀 저장소 외부에 키를 노출할 수 있기 때문입니다.

컴포저는 검증된 캐스케이드를 사용합니다: 수신자 에이전트, 등록된 제공자 경로, 해당 경로에서 사용 가능한 모델, 그 정확한 모델에 사용 가능한 추론 모드. 모델 제품군과 추론 수준은 별도의 필드입니다. gpt-5.6-luna와 같은 모델 변형은 추론 수준으로 제시되어서는 안 됩니다. 경로가 지정된 메시지는 요청된 모든 필드와 일치하는 관찰된 런타임 ID를 가진 수신자 세션이 이를 확인할 때까지 REQUESTED 상태로 유지됩니다. 일치하지 않는 세션은 메시지를 확인할 수 없습니다. 그 후에만 PeerBridge가 SHA로 바인딩된 VERIFIED 경로 영수증을 추가합니다.

저장된 경로는 MCP를 통해 등록할 수 있습니다:

{
  "route_id": "codex-luna-medium",
  "agent_id": "codex-main",
  "provider_id": "openai-official",
  "model_id": "gpt-5.6-luna",
  "reasoning_mode": "medium",
  "route_class": "official"
}

검증된 응답 별칭이 있는 제공자의 경우, 별도의 바인딩을 추가하십시오:

{
  "route_id": "relay-grok-4.6",
  "agent_id": "grok-relay",
  "provider_id": "relay-grok-sui-xiang",
  "model_id": "grok-4.6",
  "response_model_id": "grok-4.6-build",
  "route_class": "relay"
}

model_id는 발신 요청 ID입니다. response_model_id는 모든 완료 응답에서 필요한 정확한 모델 ID입니다. 생략하면 기본값은 model_id입니다. 둘 다 경로 프로필과 추론 영수증에서 SHA로 바인딩됩니다.

upsert_route_profile을 해당 페이로드로 호출한 다음 모니터에서 프로필을 선택하거나 send_message에 route_profile_id를 전달하십시오. 프로필과 사용자가 입력한 라벨은 라우팅 요청일 뿐, 업스트림 ID의 증거가 아닙니다. 각 MCP 피어를 실제 관찰된 라벨(예: --reasoning-mode)과 함께 실행하여 영수증 게이트가 이를 확인할 수 있도록 하십시오.

권장 워크플로우

1. 각 에이전트는 작업을 시작하기 전에 bridge_status와 workboard를 호출합니다.

2. 의도된 작성자는 정확한 읽기 및 쓰기 경로로 claim_task를 호출합니다.

3. 작성자는 PeerBridge 외부에서 작업하는 동안 announce_work를 호출합니다.

4. record_proof로 실시간 해시와 테스트 증거를 기록합니다.

5. 승인 정책에 피어가 필요한 경우 request_review를 호출합니다.

6. 피어는 바인딩된 아티팩트를 읽고 submit_review를 호출합니다.

7. 작성자는 complete_task를 호출합니다. PeerBridge가 파일을 다시 해싱하고 정책을 확인합니다.

8. 누구나 verify_audit_chain을 호출하거나 peerbridge doctor를 실행할 수 있습니다.

request_review는 수동 거버넌스 대기열입니다. 모델을 호출하지 않으며, 채팅방이 아닌 리뷰 페이지에 표시됩니다. 경로가 지정된 채팅방 에이전트를 깨우려면 post_room_message를 통해 게시하십시오. once는 한 번의 병렬 라운드를 보내고, discussion은 제한된 병렬 라운드를 실행합니다. 응답은 자체적으로 다른 팬아웃을 트리거하지 않습니다.

PeerBridge는 작업을 조정합니다. 코딩 클라이언트는 여전히 일반 도구를 사용하여 파일을 읽고, 편집하고, 테스트합니다.

승인 모드

상태 인식 모드는 간헐적 사용을 지원합니다. 명명된 피어가 실제로 활성 상태일 때는 리뷰를 요구하면서도 유료 에이전트가 하나만 실행 중일 때 모든 작업을 차단하지 않습니다. 정족수 모드는 3개 이상의 독립적으로 연결된 에이전트를 대상으로 합니다. 해당 에이전트를 시작하거나, 비용을 지불하거나, 인증하지 않습니다.

보안 경계

• .peerbridge/는 대화 및 작업 메타데이터를 포함할 수 있습니다. gitignore에 포함되지만 암호화되지 않습니다. 운영 체제 권한으로 프로젝트 디렉토리를 보호하십시오.

• 메모리 본문은 명시적인 조정 데이터일 뿐, 암호화된 비밀 저장소가 아닙니다. 메모리 레코드에 자격 증명, 숨겨진 추론 또는 관련 없는 개인 데이터를 절대 넣지 마십시오.

• 비밀 감지는 실패-종료(fail-closed) 최선의 필터이지, 완전한 DLP 시스템이 아닙니다.

• 감사 체인은 많은 변형을 감지하지만, 고정되지 않은 테일의 삭제는 데이터베이스만으로 증명할 수 없습니다. 중요한 체인 헤드를 내보내거나 외부에 고정하십시오.

• 파일 시스템에 접근할 수 있는 악의적인 로컬 사용자는 현재 위협 모델의 범위를 벗어납니다.

• 로컬 프로세스는 루프백에 도달하고 프록시 헤더를 위조할 수 있습니다. 운영 체제 계정은 비공개 모바일 모드에서 신뢰할 수 있는 경계로 남아 있습니다.

• PeerBridge는 리뷰를 파괴적인 셸 명령 실행 권한으로 해석하지 않습니다.

민감한 저장소에서 브리지를 사용하기 전에 전체 위협 모델을 읽으십시오.

비목표

• 다른 AI 모델을 자동으로 깨우거나 비용을 지불합니다.

• Git, 코드 리뷰, CI 또는 저장소 권한을 대체합니다.

• 생성된 패치를 적용합니다.

• 원격 멀티 테넌트 MCP 서비스를 호스팅합니다.

• 로컬 SQLite 데이터베이스를 암호화합니다.

• AI 리뷰가 인간 보안 리뷰와 동등하다고 주장합니다.

개발

python -m pytest
python -m compileall -q src
python -m build

CONTRIBUTING.md, 아키텍처, 데모 워크스루를 참조하세요. 향후 클라우드 및 모바일 작업은 로드맵에 명시적으로 분리되어 있습니다.

라이선스

Apache License 2.0. LICENSE를 참조하세요.

PeerBridge 이름과 로고는 별도의 브랜드 자산이며 Apache-2.0에 따라 라이선스가 부여되지 않습니다. 브랜드 자산 출처 및 상표 가이드라인을 참조하세요.