endy: 코딩 에이전트를 위한 로컬 제어 평면 및 tmux 관리자

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

TL;DR

endy는 로컬 환경에서 여러 코딩 에이전트를 효율적으로 운영하기 위한 제어 평면(Control Plane) 도구이다. Codex, OpenCode, CommandCode, Hermes와 같은 CLI 기반 에이전트들을 tmux 세션 내에서 실행하며, 모든 작업 내역을 .logs/ 디렉토리에 구조화하여 저장한다. 사용자는 단일 명령어로 작업을 생성(spawn), 감시(watch), 재개(resume)할 수 있으며 터미널 UI뿐만 아니라 웹 대시보드를 통해서도 상태를 확인할 수 있다. 특히 에이전트 간의 위임(delegation)을 지원하여 복잡한 개발 워크플로우를 자동화하는 데 최적화되어 있다.

배경

macOS 또는 Linux 환경, Python 3, tmux, 최소 하나 이상의 지원 에이전트 CLI (Codex, OpenCode, CommandCode, Hermes 중 하나)

대상 독자

로컬 환경에서 여러 LLM 코딩 에이전트를 동시에 운영하고 관리하려는 개발자

의미 / 영향

이 도구는 개별적으로 작동하던 코딩 에이전트들을 하나의 제어 체계로 묶어 '에이전트 오케스트레이션'을 로컬에서 구현 가능하게 합니다. 특히 작업 이력의 영구 저장과 재개 기능을 통해 에이전트의 신뢰성을 높이고 복잡한 개발 태스크의 자동화 수준을 한 단계 끌어올릴 것으로 보입니다.

섹션별 상세

다양한 CLI 코딩 에이전트를 tmux 세션 기반으로 통합 관리한다. endy start 명령으로 프로젝트별 tmux 세션을 생성하며, 각 세션 내에서 오케스트레이터, 감시, 문서, 트리 윈도우를 자동으로 구성하여 작업 환경을 표준화한다.

모든 에이전트 작업은 .logs/ 디렉토리에 메타데이터, 프롬프트, 실행 로그 세 가지 파일로 엄격하게 기록된다. task-.meta 파일에는 에이전트 종류, 작업 디렉토리, 상위 작업 ID 등이 저장되어 작업 간의 계층 구조와 맥락을 유지할 수 있게 한다.

endy spawn 명령을 통해 장시간 소요되는 비지도(unsupervised) 작업을 백그라운드에서 실행할 수 있다. 기본적으로 --full-auto 플래그를 사용하여 에이전트에게 파일 시스템 수정 권한을 부여하며, 작업이 완료되거나 실패할 때까지 tmux 윈도우에서 독립적으로 실행된다.

실시간 모니터링을 위해 터미널 기반의 endy watch 도구 모음과 웹 대시보드를 제공한다. fzf를 활용한 인터랙티브 작업 선택기(browse)나 트리 형태의 작업 현황(tree)을 통해 수많은 에이전트의 진행 상황을 한눈에 파악하고 필요시 즉시 개입할 수 있다.

에이전트 간의 협업과 작업 재개를 지원하는 기능을 포함한다. endy watch followup 명령은 이전 작업의 로그와 맥락을 주입하여 새로운 작업을 생성하며, Codex와 같은 에이전트가 다른 에이전트에게 작업을 위임할 수 있는 전용 스킬(skill)을 제공한다.

실무 Takeaway

복잡한 리팩터링이나 테스트 코드 작성을 위해 endy spawn opencode -- '명령어' 형식을 사용하여 비동기적으로 작업을 자동화할 수 있다.
시스템 프롬프트나 맥락이 반복되는 다중 에이전트 환경에서 .logs/의 메타데이터를 활용해 작업 이력을 추적하고 디버깅 효율을 높일 수 있다.
Tailscale과 연동된 endy web 기능을 사용하여 모바일 기기에서도 로컬에서 실행 중인 코딩 에이전트의 상태를 실시간으로 모니터링하고 제어할 수 있다.

언급된 리소스

GitHubendy GitHub Repository