relay란 무엇인가요?

기능을 설명하면, AI 에이전트 팀이 함께 만들어냅니다.

그게 relay입니다. 순서를 기다리지 않습니다. 단계도 없습니다. 병렬로 움직이는 진짜 팀입니다.

relay dashboard — live session in progress

단일 에이전트 AI의 한계

대부분의 AI 코딩 도구는 하나의 에이전트가 모든 걸 처리합니다 — 계획, 조사, 코딩, 리뷰, 테스트, 배포까지, 순차적으로, 하나의 컨텍스트 윈도우 안에서. 간단한 작업에는 문제없지만, 복잡한 작업에선 금방 한계에 부딪힙니다.

에이전트 하나로는 전문화도, 병렬 처리도, 자기 실수를 잡아내는 것도 어렵습니다.

relay는 다릅니다

relay는 Claude Code 서브에이전트로 구성된 팀을 만듭니다. 각 에이전트는 고유한 역할, 페르소나, 판단력을 갖고, 동시에 실행되며, 공유 MCP 서버를 통해 소통합니다. 작업이 끝날 때까지 P2P로 협업합니다.

단계도 없고, 순서를 기다릴 필요도 없습니다. 팀이 병렬로 움직일 뿐입니다.

실시간으로 지켜보세요

http://localhost:3456의 실시간 대시보드는 에이전트가 작업하는 동안 WebSocket으로 계속 업데이트됩니다:

세션 진행 위젯 — 헤더에서 태스크 완료 비율, 활성 에이전트 수, 경과 시간을 한눈에 확인
Agent Arena — 모든 에이전트를 나란히 표시. 실시간 상태, 현재 생각 스니펫, 카드별 태스크 완료 미니 바 제공
Activity Feed — 메시지, 추론 스트림, 태스크 변경, 아티팩트를 하나의 타임라인으로 통합. 키보드 단축키(j/k/Enter/Escape)로 탐색 가능
Task Board — 색상별 프로그레스 바와 의존성 표시(“Blocked by N” / “Blocks N tasks”)를 갖춘 접기 가능한 Kanban
모바일 레이아웃 — 좁은 화면에서는 하단 탭 내비게이션(Agents / Activity / Tasks)으로 전환

세션 데이터는 서버 프로세스가 살아있는 동안 in-memory로 유지됩니다.

어떤 팀이든, 어떤 도메인이든

relay에는 기본 제공 에이전트가 없습니다. .relay/agents.pool.yml에 에이전트 풀을 정의하면 relay가 태스크에 맞는 최적의 팀을 선발합니다:

agents:
  pm:
    name: Project Manager
    emoji: "📋"
    tags: [planning, coordination]
    tools: [create_task, get_all_tasks, send_message, get_messages]
    systemPrompt: |
      당신은 프로젝트 매니저입니다. 요구사항을 태스크로 분해하세요.

  researcher:
    name: Researcher
    emoji: "🔬"
    tags: [research, analysis]
    tools: [claim_task, post_artifact, send_message]
    systemPrompt: |
      당신은 리서처입니다. 주제를 조사하고 결과를 아티팩트로 게시하세요.

  researcher2:
    extends: researcher # 페르소나를 상속하고 필드를 오버라이드
    name: Senior Researcher
    emoji: "🔭"

웹 개발팀, 리서치팀, 마케팅팀, 법무팀 — 시스템 프롬프트로 역할을 정의할 수 있다면, relay가 실행합니다.

구조

relay는 Claude Code 플러그인입니다. Claude Code v1.0.33 이상이 필요하며, Claude Code 안에서 /plugin marketplace add와 /plugin install로 설치합니다. 자세한 내용은 설치 가이드를 참고하세요.

relay는 세 가지 레이어로 구성됩니다:

레이어	역할
MCP server	메시지 버스, 태스크 보드, 아티팩트 저장소, 메모리 레이어. Claude API를 호출하지 않는 순수 인프라.
Skills	Claude Code에게 에이전트 오케스트레이션 방법을 알려주는 `.md` 파일. 코드 대신 텍스트를 수정해 동작을 바꿉니다.
Hooks	`PostToolUse` (대시보드 푸시), `PreToolUse` (편집 가드), `Stop` (오케스트레이터 정리), `SessionEnd` (비동기 세션 정리).

무엇을 얻을 수 있나요

병렬 실행 — 모든 에이전트가 동시에 시작하며, 순차 단계 없음
원자적 태스크 클레임 — 에이전트들이 태스크를 경쟁적으로 클레임. claim_task는 레이스 컨디션에 안전
영속 메모리 — 세션 종료 후 에이전트가 학습 내용을 .relay/memory/에 기록하면, 다음 세션이 이어받음
실시간 대시보드 — http://localhost:3456에서 태스크, 메시지, 에이전트 추론을 실시간 확인
세션 요약 아카이브 — 각 세션이 .relay/sessions/에 저장되며, get_session_summary로 이전 컨텍스트를 불러올 수 있음

시작할 준비가 됐나요? relay 설치하기 →