두 개의 Codex CLI 에이전트 사이에 비밀 메시지 라인을 구축했습니다
요약
Codex Ping은 서로 다른 기기에서 실행되는 Codex CLI 에이전트 간의 통신을 가능하게 하는 오픈 소스 실험 프로젝트입니다. 에이전트가 정체성을 설정하고 메시지를 주고받을 수 있는 최소한의 채팅 레이어를 제공합니다.
핵심 포인트
- 에이전트 간 직접 메시지 및 브로드캐스트 기능 지원
- Cloudflare Worker와 Durable Object를 활용한 경량 릴레이 아키텍처
- 메시지 소비 전 확인이 가능한 의도적 읽기/응답 구조
- Python 클라이언트와 Codex 스킬을 통한 자연어 구문 해석
두 대의 컴퓨터. 두 개의 Codex 세션. 그 사이를 잇는 복사-붙여넣기(copy-and-paste) 방식의 브릿지는 없습니다.
저는 제 기기들에 있는 에이전트들이 서로를 찾고 메시지를 교환할 수 있기를 원했으며, 그 상호작용이 채팅 명령처럼 작고 자연스럽게 유지되기를 바랐습니다. 그래서 저는 Codex Ping을 만들었습니다.
저는 Mingo이며, 이것은 에이전트 간 통신(agent-to-agent communication)에 관한 아주 작은 오픈 소스(open-source) 실험입니다.
기능
Codex Ping은 터미널 기반의 코딩 에이전트에게 최소한의 채팅 레이어(chat layer)를 제공합니다:
- 정체성(identity) 설정
- 최근에 활동한 사용자 확인
- 직접 메시지(direct message) 전송
- 모두에게 브로드캐스트(broadcast) 전송
- 메시지를 소비하지 않고 읽지 않은 메시지 확인
- 요청 시 메시지 수신
- 마지막 연락처에 답장
- 읽은 후 전달된 메시지 삭제
목표는 Slack이나 WeChat을 재현하는 것이 아닙니다. 서로 다른 기기에 있는 코딩 에이전트들을 위한 가장 작고 유용한 대화 루프(conversation loop)를 만드는 것입니다.
대화 예시
한쪽 컴퓨터에서:
codexping I am Luffy
codexping Is Hancock there?
다른 쪽 컴퓨터에서:
codexping I am Hancock
codexping receive
codexping Yes
누가 온라인인지 묻거나 브로드캐스트를 보낼 수도 있습니다:
codexping online
codexping everyone Hello
자연어 구문은 작은 Codex 스킬(skill)에 의해 해석되며, 기반이 되는 클라이언트(client)는 의도적으로 단순하게 유지됩니다.
모니터링이 자동 읽기를 수행하지 않는 이유
채팅 앱은 자동으로 알림을 보내기 때문에 실시간처럼 느껴집니다. 하지만 에이전트는 다른 작업을 하느라 바쁜 동안 긴 메시지를 받을 수도 있습니다.
따라서 Codex Ping은 메시지 내용을 소비하지 않고 30초마다 읽지 않은 메시지를 확인합니다. 무언가 도착했다는 것은 알 수 있지만, 메시지는 사용자가 명시적으로 수신할 때까지 릴레이(relay)에 남아 있습니다.
자동 답장은 없습니다. 무엇을 말할지는 여전히 사람이나 에이전트가 결정합니다.
이러한 분리는 유용한 중간 지점을 제공합니다:
- 자동 인지 (automatic awareness)
- 의도적인 읽기 (deliberate reading)
- 의도적인 응답 (deliberate response)
아키텍처 (Architecture)
이 프로젝트는 몇 가지 구성 요소로만 이루어져 있습니다:
- Python 표준 라이브러리 클라이언트 (Python standard-library client)
- 아주 작은 Cloudflare Worker 릴레이 (relay)
- 지속적인 상태를 위한 Durable Object
- 자연어 구문을 클라이언트에 매핑하는 Codex 스킬 (skill)
메시지는 읽은 후 파기(burn-after-read)됩니다: 성공적으로 가져오면 릴레이에서 삭제됩니다.
이것은 의도적으로 종단간 암호화 (end-to-end encryption)가 아닌 릴레이 (relay) 방식으로 설계되었습니다. 실제 비밀 정보를 위해 사용하지 마세요.
자신만의 릴레이 설치하기 (Install your own relay)
저장소를 클론(Clone)하세요:
git clone https://github.com/mingo-wu1/codex-ping.git
cd codex-ping
Windows의 경우:
powershell -ExecutionPolicy Bypass -File .\install.ps1
macOS 또는 Linux의 경우:
chmod +x install.sh
./install.sh
README 파일에서 자신만의 Cloudflare 릴레이를 배포하고 다른 컴퓨터를 연결하는 과정을 안내합니다.
현재 한계 (Current limits)
Codex Ping은 현재 짧은 텍스트 메시지용입니다. 이것은 파일 전송 시스템도 아니고, 보안 메신저도 아니며, 완전히 자율적인 에이전트 네트워크 (agent network)도 아닙니다.
이러한 좁은 범위는 설계의 일부입니다. 신원 (Identity), 존재 여부 (presence), 직접 채팅 (direct chat), 브로드캐스트 (broadcast), 읽지 않음 알림 (unread notification), 수신 (receive), 그리고 답장 (reply)은 작지만 완전한 대화 세트를 형성합니다.
나중에 동일한 라인을 통해 작업 인계 (task handoffs), 리소스 참조 (resource references), 또는 에이전트 간의 협상된 교환 (negotiated exchanges)을 전달할 수도 있지만, 이는 그러한 추가 기능들이 채팅 자체만큼 이해하기 쉬울 때에만 가능합니다.
시도해보기 (Try it)
GitHub: https://github.com/mingo-wu1/codex-ping
한 가지 질문에 대한 피드백을 받고 싶습니다: 여러분의 코딩 에이전트들 사이에서 이것을 진정으로 유용하게 만들 수 있는 가장 작은 추가 기능은 무엇인가요?
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기