penso/herdr-gpui
Native client for Herdr on macOS, Linux, and Windows, built with Rust and GPUI. View terminal sessions, workspaces, Git worktrees, and agent activity through your local Herdr daemon.
개요
Herdr UI는 Herdr 데몬과 상호작용하기 위한 네이티브 데스크톱 클라이언트(Rust 및 GPUI 프레임워크로 작성)입니다. Herdr 데몬은 터미널 기반 AI 코딩 에이전트, 워크스페이스, 분할 창을 실행하는 백그라운드 서비스입니다. 별도의 터미널 에뮬레이터를 여는 대신, Herdr UI는 데몬의 터미널 셀을 그래픽 창에 직접 렌더링하고, 리치 사이드바, 탭, 분할 창 레이아웃, 마우스/키보드 상호작용을 추가합니다.
사용 대상
- AI 기반 코딩 에이전트를 실행하는 개발자(코드 작성, 테스트 실행, 웹 브라우징 등을 수행하는 에이전트)로, 이를 모니터링하고 제어하기 위한 그래픽 인터페이스를 원하는 분.
- 여러 워크스페이스 또는 Git worktree를 사용하는 파워 유저로, 호스트별 CPU/메모리를 확인하고 로컬 및 원격 SSH 머신을 전환하며 단일 창에서 에이전트를 관리하려는 분.
- 일반 터미널 UI보다 네이티브 크로스 플랫폼 UI(macOS, Linux, Windows)를 선호하는 분.
주요 기능(README 설명 기준)
| 기능 | 설명 |
|---|---|
| 터미널 렌더링 | 데몬의 터미널 셀(분할 창 포함)을 UI에 직접 렌더링. 추가 터미널 에뮬레이터 불필요. |
| 사이드바 | 호스트, 워크스페이스, worktree, AI 에이전트를 상태 점(유휴, 작업 중, 대기 중)과 함께 표시. |
| Worktree 관리 | 오른쪽 클릭 팝오버에서 worktree 생성, 이름 변경, '텔레포트'(이동), 체크포인트 보기, 삭제 가능. |
| 텔레포트 | worktree(커밋되지 않은 변경 사항, 열린 탭, 실행 중인 에이전트 포함)를 다른 SSH 호스트로 이동. |
| 에이전트 리뷰 | 에이전트 변경 사항의 diff 뷰를 열고, 줄 수준 메모를 추가하고, 피드백을 에이전트(예: Claude)로 전송. |
| 브라우저 통합 | 에이전트는 GUI 전용 브라우저 탭에서 웹 페이지를 열 수 있으며, 요소에 주석 달기, 메모 추가, 에이전트로 전송 가능. |
| 다중 레이아웃 및 테마 | 여러 사이드바 밀도와 전체 내장 또는 Ghostty 테마(라이트/다크, 사용자 정의) 선택 가능. |
| AI 사용량 패널 | 연결된 AI 서비스(예: Claude)의 사용 제한을 표시하고 잔액을 확인할 수 있음. |
| 시스템 모니터링 | 호스트별 CPU·메모리 라이브 스파크라인 표시. 원격 머신은 SSH로 읽음. |
| 네이티브 설정 | 테마 실시간 미리 보기, 검색 가능한 그리드, 글꼴/인디케이터/사운드 구성. |
| 풍부한 터미널 상호작용 | 인라인 이미지, 클릭 가능한 링크, 파일 드롭, 코드 탐색(기호 또는 path:line로 이동), 편집기 그룹, 시스템 알림. |
| 독 배지(macOS) | 에이전트가 사용자 주의가 필요할 때 배지 표시. |
작동 방식
- Herdr 데몬 실행(별도 설치). 데몬이 모든 터미널 프로세스, 워크스페이스, AI 에이전트를 소유합니다.
- Herdr UI가 연결 데몬에 로컬 소켓(
herdr-client.sock)을 통해 바이너리 프로토콜(herdr-protocol)로 연결합니다. - 데몬은 서피스 패치(터미널 셀 업데이트)를 UI로 스트리밍하고, UI는 GPUI로 렌더링합니다.
- 사용자 입력(키보드, 마우스, 클릭)은 데몬으로 다시 전송되어 적절한 터미널 또는 에이전트로 전달됩니다.
- 브라우저 탭은 UI 전용 기능으로, 데몬이 관리하지 않습니다. 에이전트는 CLI 명령을 통해 URL을 열 수 있으며, UI와는 별도의 로컬 소켓으로 통신합니다.
설치 옵션
- macOS – Homebrew cask(
brew install penso/tap/herdr-gpui), 서명된 유니버설 앱으로 열림. - Linux – 배포판에 맞는
.deb,.rpm, 또는 Arch 패키지를 선택하는 스크립트. 일반 tarball로도 제공. - Windows – 실험적인 PowerShell 스크립트로 zip 압축된
herdr-gpui.exe를%LOCALAPPDATA%\Programs\Herdr UI에 배치. - 소스에서 –
just run(QA 메뉴 포함 개발 빌드) 또는just install(Cargo의 bin 디렉토리에 바이너리 설치). 리포지토리는 Rust 1.96.1 및 GPUI 0.3.6에 고정.
성능 및 품질
- 전용 성능 벤치마크(
just test-perf)가 프레임 빌딩 대기 시간을 측정. M4 Max Mac에서 캐싱 최적화 후 호버 대기 시간이 약 51ms에서 약 12ms로 개선. - CI는 macOS, Ubuntu 24.04, Debian 13, Fedora 40, Arch에서 실행되어 패키지 설치, 라이브러리 연결, UI 렌더링 테스트.
라이선스
Apache-2.0(벤더링된 herdr-protocol에 대한 추가 고지 포함).
Herdr UI는 제휴되지 않은 타사 클라이언트이며, Herdr 데몬 자체를 포함하거나 관리하지 않습니다.
관련
- 프로젝트
- 프로젝트
- Dispatch