herdrdev/herdr

herdr – AI 코딩 에이전트를 위한 터미널 기반 런타임

무엇인가요 – herdr는 단일 바이너리로 작성된 Rust 기반 터미널 애플리케이션으로, AI 기반 코딩 에이전트(Claude, Codex, Cursor, Grok 등)를 지속 가능한 tmux 스타일의 패널 내에서 실행할 수 있게 해줍니다. 이 패널들은 백그라운드 서버에서 살아남아, 클라이언트가 연결을 끊거나 SSH 세션을 닫거나 머신을 재부팅해도 나중에 동일한 레이아웃으로 다시 연결해 이전 작업을 이어갈 수 있습니다.

주요 기능

• 분리 가능한 세션 – 클라이언트가 연결을 끊어도 패널은 계속 실행됩니다. 재연결 시 레이아웃이 복원됩니다. 원래 프로세스는 유지되지 않으며, 단지 터미널 상태만 보존됩니다.
• 다중 머신 윈도우 – 로컬과 원격 SSH 호스트를 하나의 윈도우에 혼합하여 사용할 수 있으며, 각각의 에이전트 목록과 독립적인 재연결이 가능합니다.
• 에이전트 인식 – 패널은 작업 중, 차단됨, 대기 중 상태로 표시됩니다. 에이전트는 소켓 API를 통해 새로운 패널을 생성하거나 서로 프롬프트를 주고받으며, 차단된 에이전트가 다시 사용 가능해질 때까지 기다릴 수 있습니다.
• 키보드 우선 (tmux 스타일) 및 마우스 우선 – 익숙한 접두어 키(Ctrl-b)를 사용하거나, 클릭 드래그로 패널을 분할, 리사이즈, 탐색할 수 있습니다.
• 플러그인 마켓플레이스 – 커뮤니티 플러그인을 통해 패널 동작이나 워크플로우를 확장할 수 있습니다.
• 무거운 UI 없음 – Electron이나 GUI 종속성 없이 순수 터미널 프로그램으로 작동합니다.

설치

# 1라인 설치 스크립트
curl -fsSL https://herdr.dev/install.sh | sh
# 또는 Homebrew, mise, 또는 직접 바이너리 다운로드로
brew install herdr

설치 후, 작업할 디렉터리에서 서버를 시작합니다:

herdr   # 백그라운드 서버를 시작하고 UI를 엽니다

Ctrl-b q로 분리하고, 나중에 다시 herdr를 실행하여 재연결합니다.

일반적인 워크플로우

1. 작업 스테이션 또는 원격 서버에서 herdr를 실행합니다.
2. 사용하는 AI 에이전트 패널을 엽니다 (예: claude, codex).
3. 에이전트가 코드를 생성하거나 명령어를 실행하거나 서로 입력을 요청합니다.
4. 잠시 떠나도 서버가 패널을 유지합니다. 돌아오면 다시 연결하고, 어떤 에이전트가 차단되었는지 또는 대기 중인지 확인합니다.
5. 플러그인을 추가하여 패널 처리 방식을 커스터마이즈하거나 다른 도구와 통합합니다.

대상 사용자 – LLM 기반 코딩 어시스턴트에 의존하며, 연결 끊김이나 머신 재부팅에도 견딜 수 있는 신뢰성 있는 지속 가능한 터미널 환경을 원하는 소프트웨어 개발자, 특히 여러 리모트 호스트를 넘나들며 작업하는 사용자.

문서 및 리소스 – 전체 문서, 빠른 시작 가이드, API 참조, 플러그인 마켓플레이스는 https://herdr.dev/docs 에서 제공됩니다.

라이선스 – Apache-2.0.