최근 AI 코딩 도구의 전쟁은 터미널로 옮겨왔습니다. 앤스로픽의 Claude Code, 구글의 Gemini CLI, 오픈AI 기술 기반의 Codex, 그리고 강력한 오픈소스 대안인 OpenCode까지. 각각의 도구들은 강력하지만, 우리는 매번 서로 다른 명령어를 익히고 서로 다른 터미널 창을 오가야 했습니다.
오늘 소개할 HAPI는 이러한 파편화된 환경을 완전히 뒤바꿀 게임 체인저입니다. HAPI는 “Happy” 프로젝트의 로컬 퍼스트(Local-first) 대안을 표방하며, 현존하는 주요 AI 코딩 에이전트들을 단일 허브로 통합하여 어디서든 제어할 수 있게 해줍니다.
1. HAPI란 무엇인가?
HAPI는 로컬 장비에서 실행되는 AI 코딩 세션을 래핑(Wrapping)하여, 이를 웹(Web), PWA, 그리고 텔레그램 미니 앱을 통해 원격으로 제어할 수 있게 해주는 오픈소스 플랫폼입니다.
단순히 텍스트를 전달하는 수준을 넘어, 로컬 터미널의 모든 맥락을 유지한 채 외부 기기에서 코딩을 이어나갈 수 있게 해줍니다. 개발자 tiann이 주도하는 이 프로젝트는 “Vibe Coding”을 언제 어디서나 가능하게 하는 것을 목표로 합니다.
2. 4대 AI 에이전트 완벽 통합
HAPI의 가장 큰 매력은 선택의 자유입니다. 하나의 프로젝트 안에서 상황에 따라 가장 적합한 에이전트를 골라 쓸 수 있습니다:
- Claude Code: 복잡한 추론과 대규모 리팩토링이 필요할 때.
- Gemini CLI: 구글 생태계의 도구와 거대한 컨텍스트가 필요할 때.
- Codex CLI: 신속한 코드 생성과 범용적인 도구가 필요할 때.
- OpenCode: 오픈소스 모델의 자유로움이 필요할 때.
HAPI는 이 모든 에이전트를 동일한 인터페이스 안으로 녹여내어, 도구가 바뀌어도 당신의 작업 흐름(Workflow)이 끊기지 않도록 보장합니다.
3. 핵심 혁신 기능
📱 끊김 없는 핸드오프 (Seamless Handoff)
사무실 책상에서 Claude Code로 작업하다가 점심을 먹으러 나갔나요? 스마트폰을 꺼내 HAPI 앱을 여세요. 로컬에서 진행 중이던 세션이 그대로 이어집니다. 컨텍스트 손실이나 세션 재시작 없이 모바일에서 바로 피드백을 주고받을 수 있습니다.
🎤 핸즈프리 음성 제어
HAPI는 강력한 보이스 어시스턴트를 내장하고 있습니다. 손을 쓰기 어려운 상황에서도 음성으로 작업을 지시하고 AI의 응답을 들을 수 있습니다. 이는 특히 이동 중이거나 복잡한 로직을 말로 설명하고 싶을 때 유용합니다.
🔒 종단간 암호화 (E2E Encryption)
보안은 타협의 대상이 아닙니다. HAPI는 WireGuard와 TLS를 결합한 릴레이 시스템을 통해 여러분의 기기와 작업용 PC 사이의 모든 데이터를 암호화합니다. 셀프 호스팅(Cloudflare Tunnel, Tailscale 등) 옵션도 지원하여 데이터의 주권을 온전히 가질 수 있습니다.
4. 진정한 터미널 경험의 확장
많은 웹 기반 도구들이 터미널의 인터랙티브함을 놓치곤 합니다. 하지만 HAPI는 다릅니다.
- 네이티브 퍼스트: 에이전트를 교체하는 것이 아니라 ‘감싸는’ 방식이기에, 원본 에이전트가 제공하는 근육 기억(Muscle Memory)과 터미널 경험을 그대로 유지합니다.
- 원격 터미널: 브라우저나 폰에서 로컬 터미널 명령을 직접 실행하고 결과를 컬러 출력 그대로 확인할 수 있습니다.
- AFK 승인: AI가 위험한 명령(파일 삭제, 패키지 설치 등)을 수행하려 할 때, 자리를 비운 상태에서도 폰으로 알림을 받고 터치 한 번으로 승인할 수 있습니다.
5. 시작하는 방법
HAPI는 설치와 설정이 놀라울 정도로 간단합니다.
# E2E 암호화 릴레이 허브 시작
npx @twsxtd/hapi hub --relay
# 다른 터미널에서 Claude Code 세션 연결
npx @twsxtd/hapi명령어를 실행하면 터미널에 QR 코드와 URL이 나타납니다. 이를 스캔하거나 링크를 열기만 하면 즉시 모바일 코딩 환경이 완성됩니다.
마치며: 당신의 코딩 에이전트를 ‘휴대’하세요
HAPI는 단순히 여러 도구를 모아놓은 상자가 아닙니다. AI 코딩의 물리적 한계를 허무는 인프라입니다. 이제 개발자는 강력한 워크스테이션 앞에 앉아있지 않아도, 세상 어디서나 자신의 AI 에이전트 군단을 부릴 수 있게 되었습니다.
오늘 당신의 프로젝트에 HAPI를 더해 보세요. 코딩은 더 이상 자리에 앉아 수행하는 의식이 아니라, 당신의 삶과 함께 호흡하는 흐름이 될 것입니다.
🔗 관련 정보
- GitHub 저장소: https://github.com/tiann/hapi
- 공식 문서: https://hapi.run
- 텔레그램 채널: @veryhapi
- 개발자: tiann (KernelSU 개발자)