ZingerLittleBee/Heeler

해결하는 문제

Heeler은 원격 머신에서 실행 중인 코드 에이전트를 관리하고 상호작용할 수 있는 네이티브 iOS 인터페이스를 제공합니다. 데스크톱 터미널에 묶여 있을 필요 없이, 모바일 기기에서 에이전트 상태를 모니터링하고, 실시간 터미널을 조정하며, 복잡한 지시를 전송할 수 있습니다.

작동 방식

Heeler은 herdr 에이전트 우선 터미널 런타임의 보조 앱입니다. SSH를 통해 JSON API를 사용하여 herdr와 통신하며, 이벤트 스트림에는 stream-local 채널을, 인터랙티브 터미널에는 SSH PTY를 활용합니다. 보안적인 머신 등록을 위해 QR 코드 페어링을 지원하며, SSH Jump Host를 통해 라우팅이 불가능한 머신에도 연결할 수 있습니다.

대상 사용자

herdr를 사용하여 코드 에이전트를 실행하고, 진행 상황을 모니터링하고, 에이전트가 차단되었을 때 입력을 제공하며, 이동 중에도 원격 쉘을 관리하고 싶은 개발자 및 엔지니어.

주요 기능

• 에이전트 콘솔: 여러 머신에 걸쳐 모든 에이전트의 실시간 목록을 상태별로 정렬하여, 차단된 에이전트를 우선 표시.
• 네이티브 컴포저: iOS 키보드를 완전히 활용할 수 있는 전용 입력 영역. 에이전트 제어 키, 재사용 가능한 스크립트 조각, "스킬" 제안 기능 지원.
• 터미널 통합: libghostty를 통해 완전한 터미널 에뮬레이션. 네이티브 스크롤백, 모멘텀 터치 스크롤, 전체 화면 TUI 지원.
• 모바일 최적화 알림: 엔드투엔드 암호화된 푸시 알림과 iOS Live Activities / Dynamic Island를 통한 실시간 에이전트 상태 추적.
• 보안 연결: iOS Keychain에 저장된 개인 키를 사용한 SSH 기반 전송, 최대 64 MiB까지의 SFTP 파일 첨부 지원.