relaydeck — Micro-Agent Orchestrator for Local Agents

요약

relaydeck는 CLI 코딩 에이전트를 위한 로컬 우선 fleet OS. 하나의 데몬으로 여러 AI 코딩 에이전트(Claude Code, Codex, Cursor, pi 등)를 병렬로 실행하고, 웹 대시보드에서 모니터링/메시징/자동화할 수 있다. 30+ 플러그인 시스템, 로컬 SQLite 저장소, 온폰 볼트 암호 관리. 클라우드 계정/텔레메트리 불필요. Python 3.12+, MIT 라이선스.

상세 분석

아키텍처 개요

CLI / scripts → relaydeck daemon (orchestrator + plugins + event bus) → Web dashboard (localhost:8765)
                    ├── Harness PTYs (claude, codex, cursor, pi...)
                    ├── SQLite state (agents, msgs, usage, events)
                    └── Plugin system (30+ plugins)

핵심 설계 원칙:

Everything is a plugin — harness, vault, metering, messaging, skills 모두 플러그인. 코어는 플러그인을 정적 임포트하지 않음.
One primitive: the agent — 모든 장기 실행 작업은 BaseAgent 서브클래스
YAML is the spec, SQLite mirrors it — 에이전트 정의는 ~/.relaydeck/agents/<id>.yaml이 진실 공급원
Web dashboard is THE primary interface — CLI와 동등한 기능, 둘 다 동일한 HTTP API 사용
CLI ↔ daemon over HTTP — 로컬 오케스트레이터 직접 호출 금지, 항상 데몬을 통해

지원 Harness (7종)

Harness	CLI	Agent Type	특징
Claude Code	`claude`	claude-code	권한 모드, 훅 통합
Codex	`codex`	codex-cli	샌드박스 + 승인 변환
Cursor	`cursor-agent`	cursor-cli	구독 인증, 에이전트별 설정 디렉토리
OpenCode	`opencode`	opencode-cli	설정 파일 기반 명령어 주입
Antigravity	`agy`	antigravity	Google 계정 인증
pi	`pi`	pi	레퍼런스 harness
relaydeck native	`pi`	relaydeck	fleet operator (pi + 확장 도구)

주요 플러그인 (30+)

플러그인	기능
vault	시크릿 볼트 (키 이름만 노출)
github	GitHub 이슈/PR 폴링 → 에이전트 라우팅
telegram	텔레그램 채팅으로 에이전트 원격 제어
messaging	durable 에이전트 간 인박스
prompts	에이전트가 선택지 질문
hitl	Human-in-the-loop 에스컬레이션
metering / usage_limits	토큰/비용 타일, 세션/주간 할당량
skills / theme / dashboard	에이전트 작성 스킬, 테마, 대시보드 레이아웃
file_watcher / gateway / loop	파일 이벤트, 웹훅, 스케줄/이벤트 기반 에이전트

의미론적 상태 (Semantic Status)

에이전트가 현재 무엇을 하고 있는지 표현: working, awaiting-input, complete-unread, idle

상태 출처: hook (vendor), engine (PTY 스크린 샘플러), hitl/manual
대시보드와 CLI에서 실시간 확인 가능

Telegram 원격 제어

명령어	효과
`/new`	신규 세션 시작
`/restart`	PTY 재시작 (히스토리 유지)
`/screenshot`	라이브 터미널 스냅샷
`/stop` / `/status` / `/help`	중지/상태/도움말

에이전트 메타 레이어

각 에이전트는 YAML로 정의된 identity 보유: id, type, workspace, purpose, tags, system_prompt, inject_identity_preamble

에이전트 시작 시 자동 identity preamble 생성 → peer 발견 및 메시징 지원
relaydeck workspace message "<body>" --agent <peer-id>로 협업

Git Worktree 지원

병렬 브랜치 작업을 위한 first-class workspace. relaydeck/worktrees.py가 코어에 포함됨 (플러그인 아님).

외부 에이전트 관찰 (Read-only)

Hermes Agent, OpenClaw 런타임을 읽기 전용으로 관찰: 상태/리스크 보고, 변경/시크릿 접근 불가.

기술 스택

구성	기술
엔진	Python 3.12+ (FastAPI)
대시보드	Lit (build-less), xterm.js, IBM Plex, JetBrains Mono
저장소	SQLite (~/.relaydeck/runtime/relaydeck.db)
스트리밍	SSE (이벤트), WebSocket (PTY 출력)
설치	PyPI / install.sh (curl)
라이선스	MIT

연결

[[Agent Orchestration]] — 멀티 에이전트 오케스트레이션 개념
[[Pi Agent]] — 레퍼런스 harness로 사용됨
[[RTK Token Optimization]] — CLI 명령어 출력 최적화 (relaydeck과 보완 관계)

인용

“Orchestrate agents. Plug the world in. One local daemon, one dashboard, your entire fleet.”

“No cloud account. No telemetry.”

원문

# relaydeck — micro-agent orchestrator for local agents

One local daemon, one dashboard, your entire fleet.
Run CLI coding agents in parallel: live terminals, durable peer-to-peer messaging,
your choice of model providers, and a plugin stack you extend per workspace.
No cloud account. No telemetry.

## Key Features
- Harness-native: Drives real CLI agents (Claude Code, Codex, Cursor, etc.)
- Local-first: State in ~/.relaydeck + SQLite
- Fleet-aware: Agents discover peers by purpose/tags
- Observable: Live PTY terminals, semantic status, SSE
- Plugin-extensible: 30+ plugins

## Installation
curl -fsSL https://relaydeck.ai/install.sh | sh
pip install relaydeck
relaydeck daemon start