dominikmartn/harp

Run many Claude Code and Codex agents side by side, in one sidebar that tells you which one needs you. An unofficial fork of Warp.

Harp란 무엇인가요?

Harp는 오픈 소스 Warp 터미널을 기반으로 하는 macOS 터미널 애플리케이션입니다. Warp의 가로 탭 바를 Claude Code 및 Codex와 같은 장기 실행 AI 코딩 에이전트의 상태를 표시하도록 특별히 설계된 사이드바로 대체합니다. 터미널의 나머지 부분은 업스트림 Warp와 정확히 동일하게 작동합니다. 빠른 렌더링, 클라우드 백업 세션, 내장 AI 기능을 그대로 사용할 수 있지만 Harp는 여러 AI 기반 코딩 세션을 더 쉽게 추적할 수 있는 UI 레이어를 추가합니다.

핵심 기능

기능	설명
에이전트 상태 사이드바	각 행은 Claude Code 또는 Codex 세션을 나타냅니다. 아이콘은 에이전트가 작업 중, 사용자 대기 중, 완료, 또는 백그라운드에서 실행 중인지 여부를 표시합니다. 읽지 않은 활동은 볼 때까지 강조 표시됩니다.
그룹 탭	탭을 이름 있는 그룹에 배치할 수 있습니다. 선택적 tmux 통합을 활성화하면 그룹 이름, 순서, 플래그가 tmux에 저장되어 레이아웃이 재시작 후에도 유지되고 다른 tmux 클라이언트와 공유됩니다.
사용량 링 푸터	하단의 작은 링에 Claude와 Codex의 5시간 및 주간 사용량 제한이 표시됩니다. 숫자는 사용자가 최신 상태로 유지하는 로컬 JSON 파일에서 읽습니다. Harp는 이 숫자를 위해 외부 서비스에 연락하지 않습니다.
모바일 친화적 tmux 통합	tmux 세션이 다른 곳(예: 휴대폰에서 SSH)에서 시작되면 `@warp_adopt` tmux 옵션을 사용하여 기존 Harp 탭을 채택할 수 있습니다.
사용자 지정 가능한 설정	모든 추가 UI 요소는 기본적으로 꺼져 있습니다. `~/.harp/settings.toml`에서 활성화할 수 있습니다. 변경 사항은 자동으로 다시 로드됩니다.
Warp와 동일한 AI 백엔드	Harp는 자체 서버를 실행하지 않습니다. 모든 AI 호출(Claude Code, Codex, Warp Drive, 세션 공유)은 업스트림 앱과 정확히 동일하게 Warp의 공식 백엔드로 전송됩니다.

설치 및 업데이트

바이너리 릴리스 – GitHub Releases 페이지에서 최신 Harp-<version>.dmg를 다운로드하여 /Applications에 드래그합니다. Harp는 자체 번들 식별자(com.dominikmartn.Harp)를 사용하고 설정을 ~/.harp에 저장하므로 일반 Warp 설치와 공존할 수 있습니다.
자동 업데이트 – Harp는 10분마다 GitHub 릴리스 페이지를 폴링합니다. 새 버전이 발견되면 DMG를 다운로드하고 서명을 확인한 다음 새 빌드로 다시 시작하라는 메시지를 표시합니다.
소스에서 빌드 – macOS 및 Rust 툴체인(rust-toolchain.toml에 지정)이 필요합니다.
```
./script/bootstrap   # 툴체인 및 종속성 설치
./script/run        # Harp.app 빌드 및 실행
```
script/macos/run 헬퍼는 발견된 첫 번째 "Apple Development" ID로 앱에 서명하며, 없으면 ad-hoc 서명으로 대체합니다.

구성 (settings.toml)

[integrations.limit_rings]
enabled = true          # 사용량 링 표시
file = "~/.cache/limit-rings.json"  # 숫자용 JSON 소스

[integrations.tmux]
enabled = true          # 그룹, 순서, 플래그를 tmux와 동기화
session_script = ""    # 이름 변경/재그룹화용 선택적 외부 스크립트

다른 토글을 사용하면 탭 메뉴를 축소하고 업스트림 CLI 에이전트 도구 모음을 복원할 수 있습니다. 파일을 변경하면 자동으로 다시 로드됩니다.

누가 사용할까요?

AI 코딩 어시스턴트(Claude Code, Codex)에 의존하는 개발자로, 어떤 어시스턴트가 아직 처리 중인지, 입력을 기다리는지, 완료되었는지 빠르게 시각적으로 확인해야 하는 사람.
tmux 고급 사용자로, AI 기반 터미널 탭이 SSH 세션 간에 유지되고 모바일 장치에서 볼 수 있기를 원하는 사람.
Warp의 성능은 좋아하지만 많은 AI 세션이 열려 있을 때 확장성이 더 좋은 세로 레이아웃을 선호하는 사람.

라이선스

코드는 GNU AGPL-3.0(Warp와 동일)으로 릴리스되며, 일부 UI 크레이트(warpui, warpui_core)는 MIT 라이선스로 제공됩니다. 네트워크를 통해 다른 사람에게 수정된 버전을 제공하는 경우 AGPL은 소스를 제공해야 합니다.

빠른 시작 체크리스트

DMG를 설치하거나 소스에서 빌드합니다.
Harp를 열고 로그인합니다(Warp와 동일한 자격 증명).
~/.harp/settings.toml에서 원하는 사이드바 기능을 활성화합니다.
(선택 사항) 그룹을 동기화하려면 tmux 통합을 켭니다.
Claude Code 또는 Codex 세션을 엽니다. 사이드바가 자동으로 업데이트되는지 확인합니다.

Harp는 Warp의 비공식 포크이며 Warp 회사와 관련이 없습니다. 모든 버그 보고서는 Warp의 이슈 트래커가 아닌 이 저장소에 제출해야 합니다.