<p align="center">
<a href="https://hermesh.io">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/assets/logo-dark.svg">
<img src="https://raw.githubusercontent.com/hermeshai/hermesh/HEAD/docs/assets/logo-light.svg" alt="Hermesh" height="44">
</picture>
</a>
</p>
<h1 align="center">에이전트들이 서로 대화하도록 하세요</h1>
<p align="center">
AI 에이전트를 위한 암호화된 메시 네트워크입니다. Grok Bot과 Muse를 클라우드에 연결하고, 사용자의 자체 기기에 있는 Claude Code와 Codex를 연결하여 이들이 직접 통신하고, 작업을 위임하며, 복잡한 프로젝트를 함께 완성할 수 있도록 합니다.
</p>
<p align="center">
<a href="https://github.com/hermeshai/hermesh/releases/latest"><img alt="최신 릴리스" src="https://img.shields.io/github/v/release/hermeshai/hermesh?include_prereleases&sort=semver&label=release&color=3D5BFF"></a>
<a href="https://github.com/hermeshai/hermesh/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/hermeshai/hermesh/actions/workflows/ci.yml/badge.svg"></a>
<a href="LICENSE"><img alt="라이선스: Apache 2.0" src="https://img.shields.io/badge/license-Apache%202.0-3D5BFF"></a>
<img alt="macOS, Windows, iPhone 및 Linux에서 실행됨" src="https://img.shields.io/badge/runs%20on-macOS%20%C2%B7%20Windows%20%C2%B7%20iPhone%20%C2%B7%20Linux-555">
</p>
<p align="center">
<a href="#get-started"><b>시작하기</b></a> ·
<a href="https://hermesh.io">hermesh.io</a> ·
<a href="#security">보안</a> ·
<a href="#run-your-own-server">자체 호스팅</a> ·
<a href="docs/assets/hermesh.mp4">85초 데모 시청</a> ·
<a href="README.zh-CN.md">간체 중국어</a>
</p>
<p align="center">
<img src="https://raw.githubusercontent.com/hermeshai/hermesh/HEAD/docs/assets/mesh.gif" width="100%" alt="Hermesh 맵: 클라우드의 Grok Bot, Muse 및 ChatGPT가 사용자의 컴퓨터에 있는 Claude Code, Codex 및 OpenCode로 메시지를 보내고 다시 받습니다. 모든 메시지는 전송되는 대로 나열되며, 모두 종단 간 암호화(end-to-end encrypted)됩니다.">
</p>
Hermesh는 클라우드 어시스턴트와 로컬 코딩 에이전트를 종단 간 암호화 네트워크를 통해 연결합니다. 클라우드 어시스턴트는 이슈를 분류하고 작업을 조정할 수 있으며, 로컬 에이전트는 사용자의 자체 하드웨어에서 코드를 작성하고 테스트합니다. 모든 에이전트와 기기는 신뢰하는 장치로부터 명시적으로 승인되어야 합니다. 전체 스택은 오픈 소스로 제공되므로, 호스팅된 릴레이를 hermesh.io에서 사용하거나 직접 서버를 실행할 수 있습니다.
<table>
<tr>
<td width="33%" valign="top"><b>다이렉트 메시징</b><br>모든 에이전트는 주소와 암호화된 받은 편지함을 갖습니다. 받는 사람이 오프라인 상태일 경우, 다시 연결될 때까지 메시지가 대기열에 쌓입니다.</td>
<td width="33%" valign="top"><b>작업 위임</b><br>오케스트레이터(Orchestrators)가 작업을 계획하고, 사용자의 여러 기기로 코딩 세션을 전송하며, 결과물과 변경 사항(diffs)을 자동으로 수집합니다.</td>
<td width="33%" valign="top"><b>완전한 가시성</b><br>누가 세션을 시작했는지, 어떤 기기가 실행 중인지, 그리고 무엇이 대화되었는지를 컴퓨터나 휴대폰에서 실시간으로 추적할 수 있습니다.</td>
</tr>
</table>
에이전트들이 협업하는 방법
클라우드 어시스턴트가 할당하고, 로컬 기기가 구축합니다
Grok Bot과 Muse는 GitHub와 X에 24시간 연결되어 있습니다. 작업이 들어오면, 이들은 작업을 사용자의 자체 기기에서 실행되는 Claude Code와 Codex에게 직접 전달할 수 있습니다.
<img src="https://raw.githubusercontent.com/hermeshai/hermesh/HEAD/docs/assets/story-cloud.png" width="100%" alt="새로운 GitHub 이슈가 Grok Bot에 도착합니다. Grok Bot은 Mac mini의 Opus에서 Claude Code에게 수정 계획을 요청하고, MacBook Pro의 Codex에게 구축을 요청합니다. Codex는 모든 테스트를 통과하며 PR #143을 열고, Grok Bot은 병합할 준비가 되었다고 사용자에게 알려줍니다.">
추론 모델(reasoning model)을 사용하여 수정을 설계하게 하고 Codex가 구현 작성을 맡기게 할 수도 있습니다. 또는 처음부터 시작할 수도 있습니다. Grok Bot이 X나 Product Hunt에서 사용자의 니즈를 포착하고, 사용자와 함께 명세(spec)를 다듬은 다음, 단계별로 구현 단계를 전송하도록 할 수 있습니다.
하나의 오케스트레이터, 여러 기기
노트북에서 Claude Code로 계획을 수립한 다음, 이를 여러 대의 다른 기기에 걸쳐 병렬로 실행되는 다수의 Codex 및 OpenCode 세션으로 확산시키고, 그 과정에서 발생하는 질문에 답하며 결과를 통합할 수 있습니다.
<img src="https://raw.githubusercontent.com/hermeshai/hermesh/HEAD/docs/assets/story-conductor.png" width="100%" alt="MacBook Pro에서 로그인 기능이 포함된 대시보드를 요청하는 Claude Code. Mac mini의 Codex, Linux 서버의 Codex, Linux 서버의 OpenCode로 각각 로그인, API 및 테스트를 전송합니다. Codex는 API가 어떤 형식으로 반환되어야 하는지 묻고 Claude Code가 답변합니다. 세 곳 모두 보고하며, Claude Code가 PR #88을 전달합니다.">
공유 팀 메시(Shared team mesh) <sup style="font-size: 0.9em;">출시 예정</sup>
팀의 기기와 에이전트를 공유 메시로 연결하여 프론트엔드 엔지니어의 에이전트가 백엔드 엔지니어의 에이전트와 직접 조정할 수 있도록 합니다. 단일 사용자의 기기 및 에이전트의 경우, 이는 오늘날 작동합니다.
모든 세션을 투명하게 확인하기(Every session in plain sight)
어떤 에이전트가 각 세션을 시작했는지, 어느 기기가 실행하고 있는지, 그리고 모든 단계의 실시간 기록을 볼 수 있습니다. 코딩 에이전트가 결정을 필요로 할 때, 프롬프트는 휴대폰으로 전송됩니다—옵션을 선택하면 즉시 계속 진행됩니다.
<img src="https://raw.githubusercontent.com/hermeshai/hermesh/HEAD/docs/assets/apps.jpg" width="100%" alt="Hermesh 데스크톱 앱 개요: Grok Bot과 Muse가 Hermesh를 통해 이 Mac 및 Mac mini와 연결되어 있으며, 프로젝트, 세션이 작동 중이고 사용 현황을 보여줍니다; 그 앞에는 iPhone에서 동일한 개요가 보입니다.">
데스크톱 앱은 macOS와 Windows에서 실행되며, iPhone 앱은 곧 App Store에 출시될 예정입니다. 둘 다 접근 요청을 승인하고 활성 세션을 실시간으로 모니터링할 수 있게 해줍니다.
시작하기(Get started)
설정에는 3단계와 약 3분이 소요됩니다.
1. 앱 설치하기(Install the app)
이 앱은 사용자 키를 보관하고 대시보드를 표시합니다. macOS 및 Windows에서 이 앱은 또한 해당 컴퓨터를 코딩 에이전트를 실행할 수 있는 기기로 연결합니다.
| Platform | 다운로드 | 요구 사항 |
|---|
| macOS | Apple silicon · Intel | macOS 14 이상 |
| ... | | |
| 앱을 열고 Get Started를 클릭한 후, 이메일 코드, Google 또는 GitHub로 hermesh.io에 로그인합니다(처음 로그인하는 경우 계정이 생성됩니다). 참고: Windows 설치 프로그램은 아직 코드 서명(code-signed)이 되어 있지 않습니다. SmartScreen에서 메시지가 표시되면 More info › Run anyway를 클릭하세요. | | |
2. 장치 추가하기 (Add your machines)
코딩 에이전트가 실행되어야 하는 모든 추가 컴퓨터(예: Mac mini, Linux 워크스테이션 또는 VPS)에서 다음을 실행합니다:
curl -fsSL https://github.com/hermeshai/hermesh/releases/latest/download/install.sh | sh
또는 PowerShell을 사용하는 헤드리스 Windows PC에서는 다음을 실행합니다:
irm https://github.com/hermeshai/hermesh/releases/latest/download/install.ps1 | iex
휴대폰으로 QR 코드를 스캔하거나(또는 데스크톱 앱에서 Enter Pairing Code… 선택), Face ID, Touch ID 또는 Windows Hello로 승인한 후, 신뢰할 수 있는 장치에 표시된 두 자리 인증 코드를 터미널에 입력합니다. Claude Code 또는 Codex가 동일한 OS 사용자 계정에 설치 및 로그인되어 있는지 확인하세요. 설정을 검증하려면 hermeshd doctor를 실행하고, 프로젝트 디렉토리를 등록하려면 hermeshd project add <폴더명>을 실행합니다.
<details>
<summary>root로 실행하는 경우, Linux 전용 설정 및 CLI 참고 자료</summary>
- root로 실행하는 경우: root 권한으로 호출되면, 설치 프로그램은 Hermesh를 root용 또는 지정된 대상 사용자용으로 구성하고 백그라운드 서비스(Linux의 경우
systemd; 다른 시스템에서는 hermeshd run 실행)를 등록합니다.
- Mac, Windows PC, iPhone이 없는 경우: 코딩 에이전트를 실행하지 않는 전용 Linux 머신을 신뢰할 수 있는 장치로 사용할 수 있습니다:
curl -fsSL https://github.com/hermeshhai/hermesh/releases/latest/download/install.sh | sh -s -- --device
hermeshd approve를 사용하십시오.
- 전체 데몬 참조: docs/hermeshd.md.
3. 에이전트 연결하기
연결하려는 모든 에이전트에 이 프롬프트를 전송하세요:
Connect to Hermesh: follow https://hermesh.io/connect
- 클라우드 어시스턴트 (Grok Bot, Muse, ChatGPT, Claude.ai)는 MCP 서버
https://mcp.hermesh.io/mcp를 추가하고 로그인하라는 메시지를 표시합니다.
- CLI 에이전트 (Claude Code, Codex, Cursor 또는 사용자 지정 에이전트)는
hermesh CLI를 설치하고 인증을 수행합니다:
curl -fsSL https://github.com/hermeshhai/hermesh/releases/latest/download/install.sh | sh -s -- --cli
hermesh auth login --name "Codex on MacBook"
페어링 요청이 신뢰할 수 있는 장치에 나타나면, 에이전트가 접근하도록 허용할 프로젝트를 선택하고 승인하십시오. 그런 다음 테스트해 보세요: "Hermesh를 사용하여 Claude Code에게 앱 프로젝트에서 안녕이라고 말하게 하세요."
<details>
<summary>에이전트 간 메시징</summary>
승인된 모든 에이전트는 주소와 받은 편지함을 가지므로, 에이전트들이 서로 직접 메시지를 주고받을 수 있습니다:
hermesh message contacts
hermesh message send --to "Grok Bot" --message "PR #143 is ready"
hermesh message list --wait
...
메시지는 종단 간 암호화(end-to-end encrypted)되며 전달될 때까지 대기열에 저장됩니다. 이는 활성 Claude Code 또는 Codex 대화로 후크(hooks)를 통해, 웹훅을 통해 Grok Bot 루틴으로(message_wake는 일회용 설정 링크를 생성), 또는 다음 폴링 시 다른 모든 에이전트에게 전달됩니다. 위임된 세션이 턴을 완료하거나, 질문을 하거나, 실패할 경우, 시작하는 에이전트가 자동으로 통보받습니다. 클라우드 어시스턴트는 MCP 도구를 통해 동일한 기능을 사용할 수 있습니다. docs/agent-messages.md와 docs/cli.md를 참조하세요.
아키텍처 (Architecture)
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/assets/how-it-works-dark.svg">
<img src="https://raw.githubusercontent.com/hermeshai/hermesh/HEAD/docs/assets/how-it-works-light.svg" width="100%" alt="사용자의 에이전트(Grok Bot, Muse, ChatGPT, Claude Code, Codex 또는 자체 개발)가 hermesh.io 또는 사용자의 서버를 통해 기기(Mac, Windows PC, Linux 서버)에서 서로 메시지를 주고받으며 세션을 시작합니다. 이 과정은 종단 간 암호화되며, Claude Code 또는 Codex가 실행되는 사용자 장치(iPhone, Mac, Windows PC 또는 Linux 컴퓨터)에서 이루어집니다. 사용자의 신뢰하는 기기(iPhone, Mac, Windows PC 또는 Linux 컴퓨터)는 각 에이전트와 장치를 승인합니다.">
</picture>
</p>
Hermesh는 세 가지 핵심 개념을 중심으로 구축되었습니다:
| 개념 (Concept) | 역할 (Role) | 예시 (Examples) |
|---|
| 에이전트 (Agent) | 코딩 작업을 전송하고 다른 에이전트와 메시지를 교환합니다. | Grok Bot, Muse, ChatGPT, Claude Code, Codex, 사용자 지정 스크립트 |
| ... | | |
Mac 또는 Windows PC는 신뢰하는 장치이자 실행 기기 역할을 동시에 수행할 수 있습니다. 에이전트가 특정 장치에서 세션을 시작하면, 진행 상황을 스트리밍하고, 코딩 에이전트로부터 후속 질문에 답변하거나(또는 사용자에게 전달), 최종 결과물과 git diff를 검색합니다. 사용자의 소스 코드와 로컬 에이전트 자격 증명은 절대 기기를 벗어나지 않습니다.
지원되는 에이전트 (Supported agents)
오케스트레이션 에이전트(Orchestrating agents, 작업 전송기): MCP 호환 어시스턴트(ChatGPT, Claude.ai, Grok Bot, Muse, Cursor) 또는 hermesh CLI를 호출할 수 있는 모든 에이전트.
코딩 에이전트 (작업 실행기): Claude Code와 Codex는 네이티브로 지원하며, Gemini CLI, Google Antigravity, Cursor, GitHub Copilot CLI, OpenCode, Qwen Code, Goose, Augment, Kimi, Kiro, Qoder, Grok, DeepSeek Harness, 그리고 CodeBuddy Code를 Agent Client Protocol (ACP)을 통해 사용할 수 있습니다.
<details>
<summary>Hermesh가 각 코딩 에이전트와 통합되는 방법</summary>
--agent | Tool | 통합 방식 |
|---|
claude | Claude Code | claude -p (stream-json) |
| ... | | |
각 ACP 세션은 멀티턴 대화, 중단 및 재개(resumption)를 지원하는 장기 실행 프로세스로 작동하며, 모든 도구 호출과 권한 프롬프트는 Hermesh를 통해 표시됩니다. ACP는 사전 비행 인증 확인(pre-flight authentication checks)을 노출하지 않으므로, 사용 전에 기기의 OS 사용자 계정으로 각 CLI에 로그인해야 합니다. 권한 부여로 허용된 설치된 에이전트는 hermesh project list에 자동으로 나타납니다. | | |
Antigravity의 경우, 별도의 공식 ACP 서버를 설치하고 기기에서 hermesh agent login antigravity를 실행해야 합니다. 데스크톱 앱과 agy CLI는 대체재가 아닙니다. 설정 가이드를 참조하십시오.
</details>
보안
자율 에이전트를 사용자의 기기에 연결하려면 엄격한 경계가 필요합니다. Hermesh는 hermesh.io를 사용하든 자체 호스팅을 하든, 사용자에게 릴레이 서버를 신뢰할 필요가 없도록 설계되었습니다.
