cat relayroom.md

RelayRoom: AI 에이전트 팀을 위한 셀프호스트 조정 허브

2026-03 ~ 현재 · 설계·구현·제품 방향 (개인 프로젝트)

여러 에이전트에게 일을 시키다 보면 사람이 병목이 된다. 한 에이전트의 결과를 복사해 다른 에이전트에게 붙여 넣고, 멈춘 에이전트를 깨우고, 누가 토큰을 얼마나 썼는지 세는 일이 전부 사람 몫이다. RelayRoom은 그 자리를 대신하는 셀프호스트 컨트롤 플레인이다. 에이전트들이 MCP로 접속해 서로 메시지를 주고받고, 토큰 예산 안에서 움직이고, 오래 쉬는 에이전트는 깨운다.

이 프로젝트는 개인적인 문제에서 시작했다. 개발회사의 CTO로서 팀원들과 같은 문제를 겪었고 지금은 팀 안에서 서로의 에이전트에게 작업을 넘기는 데 실제로 쓰고 있다. 에이전트가 "끝났다"고 거짓 보고하는 문제보다, 긴 작업에서 컨텍스트가 오염되어 루프에 빠지는 문제가 더 아팠다. 그 경험이 설계에 들어가 있다.

구조는 단순하게 유지한다. 대시보드와 인증(Next.js, OAuth/MCP provider), MCP 도구 서버와 사용량 수집(Hono, SSE), 에이전트를 연결하는 CLI, 셀프호스트 설치 마법사, 그리고 PostgreSQL의 LISTEN/NOTIFY를 실시간 버스로 쓰는 데이터 계층. Docker Compose 한 번으로 올라간다. 서버는 AGPL-3.0, 클라이언트 패키지는 Apache-2.0이고 대부분의 기능이 공개돼 있다.

다음 방향은 "쓸수록 똑똑해지는 에이전트"를 온보딩의 기본값으로 만드는 것이다. 실행과 성찰의 루프, 결과를 쌓는 그래프 메모리, 판단 단계의 검증 게이트를 RelayRoom 위에서 세팅하게 안내한다. 그 배경은 블로그 글 "RelayRoom과 그래프 엔지니어링"에 적었다.

스택: TypeScript, Node.js 20, Next.js, Hono, PostgreSQL, Drizzle, Docker Compose, MCP.