Repolode
tiann

tiann/hapi

Claude Code, Codex 같은 AI 코딩 에이전트 세션을 내 컴퓨터에서 실행하고 휴대폰이나 웹으로 원격 제어합니다.

대체할 수 있는 제품:Happy

스타
5,269
포크
616
열린 이슈
364
마지막 커밋
21시간 전

어떤 프로젝트인가요?

HAPI는 Claude Code, Codex, Cursor Agent, OpenCode, Pi 같은 공식 AI 코딩 에이전트를 연결해, 세션은 내 컴퓨터에서 계속 실행하면서 네이티브 iOS·Android 앱, 웹 또는 PWA 클라이언트, Telegram Mini App으로 상태를 확인하고 제어할 수 있게 합니다.

작업을 이어받아 진행하는 흐름을 중심으로 설계되어, 로컬 터미널에서 작업을 시작한 뒤 자리를 비울 때 휴대폰으로 전환하고, 컨텍스트를 잃거나 세션을 다시 시작하지 않고도 터미널로 돌아올 수 있습니다. 에이전트의 승인 요청은 한 번 탭해 응답할 수 있습니다. 설정은 연결에 사용할 URL과 QR 코드를 표시하는 hub 명령으로 시작하며, 선택적으로 E2E 암호화 relay나 Cloudflare Tunnel, Tailscale 같은 자체 호스팅 터널을 통해 연결할 수 있습니다.

HAPI에는 브라우저에서 보는 터미널 화면, 음성 입력, 그리고 runner 플래그로 허용한 디렉터리만 표시하는 선택형 작업 공간 브라우저도 포함되어 있습니다.

핵심 기능

  • 01세션을 다시 시작하지 않고 로컬 터미널과 휴대폰 또는 웹 사이에서 작업을 이어갈 수 있습니다.
  • 02모바일 기기에서 에이전트 요청을 한 번 탭해 승인할 수 있습니다.
  • 03Claude Code, Codex, Cursor Agent, OpenCode, Kimi, Copilot 및 기타 에이전트를 지원합니다.
  • 04채팅, 승인, 파일, 푸시 알림을 지원하는 네이티브 iOS 및 Android 클라이언트를 제공합니다.
  • 05허용된 작업 공간 디렉터리를 웹에서 둘러보고 그 안에서 세션을 시작할 수 있습니다.

활용 사례

  • 자리를 비운 동안 휴대폰으로 장시간 실행되는 코딩 에이전트의 진행 상황을 확인할 때.
  • 워크스테이션으로 돌아가지 않고 원격으로 에이전트의 도구 요청을 승인할 때.
  • 집이나 사무실 컴퓨터에서 코딩 에이전트를 실행하고 어디서든 접속할 때.

빠른 시작

  1. 1

    E2E 암호화 릴레이로 허브를 시작합니다

    npx @twsxtd/hapi hub --relay
  2. 2

    에이전트를 선택하고 세션을 시작합니다

    npx @twsxtd/hapi
  3. 3

    허브에 표시된 웹 URL을 브라우저에서 열거나, 컴패니언 QR 코드로 네이티브 앱을 페어링합니다

사용 전 알아둘 점

  • 소스에서 빌드하려면 Bun 1.4.0이 필요합니다.
  • 릴레이를 통한 원격 액세스 또는 자체 호스팅 터널을 사용하려면 기본 명령 외에 추가 설정이 필요합니다.
  • AGPL-3.0 카피레프트 라이선스로 제공됩니다. 네트워크를 통해 사용할 경우 수정한 소스 코드를 공유해야 합니다.

토픽

자주 묻는 질문

hapi은(는) 무엇인가요?
Claude Code, Codex 같은 AI 코딩 에이전트 세션을 내 컴퓨터에서 실행하고 휴대폰이나 웹으로 원격 제어합니다. HAPI는 Claude Code, Codex, Cursor Agent, OpenCode, Pi 같은 공식 AI 코딩 에이전트를 연결해, 세션은 내 컴퓨터에서 계속 실행하면서 네이티브 iOS·Android 앱, 웹 또는 PWA 클라이언트, Telegram Mini App으로 상태를 확인하고 제어할 수 있게 합니다.
hapi은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
hapi은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
hapi은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. hapi의 마지막 커밋은 2026년 10월 19일입니다.
hapi은(는) 어디에 사용할 수 있나요?
자리를 비운 동안 휴대폰으로 장시간 실행되는 코딩 에이전트의 진행 상황을 확인할 때. 워크스테이션으로 돌아가지 않고 원격으로 에이전트의 도구 요청을 승인할 때. 집이나 사무실 컴퓨터에서 코딩 에이전트를 실행하고 어디서든 접속할 때.
hapi는 어떻게 설치하나요?
E2E 암호화 릴레이로 허브를 시작합니다: npx @twsxtd/hapi hub --relay 에이전트를 선택하고 세션을 시작합니다: npx @twsxtd/hapi 허브에 표시된 웹 URL을 브라우저에서 열거나, 컴패니언 QR 코드로 네이티브 앱을 페어링합니다
hapi은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/tiann/hapi

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트