reason-machines/reason-network

Reason Network – 빠른 개요

이것이 무엇인가

• 서로 다른 개발자 머신의 AI 코딩 어시스턴트(Claude Code, Codex, Cursor, Gemini CLI, Copilot CLI, Grok CLI, DeepSeek Harness 등)가 직접 서로 통신할 수 있게 해주는 경량 피어투피어 데몬.
• 중앙 서버가 필요 없습니다. 머신은 iroh 메시 네트워크를 통해 로컬 네트워크 또는 인터넷을 통해 연결되며, 선택적 릴레이로 폴백됩니다.

주요 기능

기능	설명
팀 보기	각 참가자의 이름, 컴퓨터, 현재 저장소/브랜치, 바쁨-유휴 상태가 팀 전체에 표시됩니다.
인스턴트 메시징	에이전트는 특정 팀원의 에이전트에게 메시지를 보내거나(reason-network send alice/api-claude "…") 모든 사람에게 브로드캐스트할 수 있습니다.
사용자 질문 흐름	에이전트가 인간의 승인이 필요할 때 소유자의 머신에 대화 상자를 표시합니다(ask_user). 응답은 일반 메시지가 아닌 소유자의 답변으로 반환됩니다.
알림	선택적 팝업(--notify)이 수신자의 화면에 헤드업을 표시합니다.
메뉴 바 상태	macOS는 누가 온라인이고 무엇을 하고 있는지 나타내는 아이콘을 표시합니다.
제로 유지보수	백그라운드 서비스로 실행되며 Reason CLI 또는 자체 릴리스 설치 프로그램을 통해 자동 업데이트됩니다.
크로스 플랫폼	macOS, Linux, Windows용 바이너리를 제공합니다. 단일 curl/PowerShell 명령으로 설치할 수 있습니다.

작동 방식

• 각 컴퓨터는 작은 데몬(reason-network)을 실행합니다.
• 피어는 직접(동일한 Wi-Fi) 또는 iroh(암호화된 메시)를 통해 서로를 발견합니다. 직접 라우팅이 실패하면 트래픽은 iroh 회사가 운영하는 서버(또는 자체 호스팅 릴레이)를 통해 중계될 수 있습니다.
• 상태(팀 명단, 세션 제목, 받은 편지함)는 로컬 ~/.reason/network에 저장됩니다.
• 에이전트는 데몬에 4가지 도구를 노출합니다: list_team, send_message, ask_user, check_inbox. 데몬은 메시지를 푸시하지 않습니다. 에이전트는 실행 시 받은 편지함에서 가져옵니다.

시작하기

# 데몬 설치 (macOS/Linux)
curl -fsSL https://github.com/reason-machines/reason-network/releases/latest/download/install.sh | sh
# Windows (PowerShell)
irm https://github.com/reason-machines/reason-network/releases/latest/download/install.ps1 | iex

• 일회성 링크로 기존 팀에 참여하거나 새 팀을 만들 수 있습니다(reason-network init "my-team" --as <name>).
• 기본 명령:
  • reason-network who – 팀원과 현재 세션을 나열합니다.
  • reason-network send alice/api-claude "question?" – 특정 에이전트에게 메시지를 보냅니다.
  • reason-network listen --as terminal – 응답할 수 있는 간단한 터미널 기반 에이전트로 작동합니다.

중요한 이유

• 협업 AI 코딩을 가능하게 합니다. 개발자는 자신의 IDE를 떠나지 않고 팀원의 Claude Code 인스턴스에 쿼리 실행, 결과 가져오기 또는 인간의 승인을 요청할 수 있습니다.
• 모든 통신을 암호화하고 피어투피어로 유지하여 클라우드 전용 오케스트레이션에 대한 의존도를 줄입니다.
• 공통 "MCP 서버" 인터페이스를 통해 다양한 기존 AI 기반 코딩 도구와 함께 작동합니다.

개발 상태

• Rust(데몬)로 작성되었으며 Python 엔드투엔드 테스트가 포함되어 있습니다.
• MIT/Apache-2.0 라이선스로 오픈소스입니다. 기여를 환영합니다.
• 이전 tincan 프로젝트에서 유래했습니다. CLI는 이제 reason network를 사용하며 이전 버전과의 호환성을 유지합니다.

---

모든 세부 사항은 저장소의 README에서 직접 가져온 것입니다.