happier-dev/happier
happier-dev/happier has 2,181 GitHub stars and 221 forks. GitHot measured +15 stars in 24 hours. Last checked 2026-11-08 22:03 UTC. Last push 2026-11-02.
Web, Desktop & Mobile client and orchestrator for Codex, Claude Code, OpenCode, Pi, Cursor, Grok, Antigravity, Kimi, Augment Code, Qwen, fully end-to-end encrypted
측정된 스타 증가
- in 24h
- +15
- in 7 days
- 기록 수집 중
- in 15 days
- 기록 수집 중
- in 1 month
- 기록 수집 중
서로 겹치는 기간의 순증가량이며 일별 합계가 아닙니다. 측정값이 없으면 비워 둡니다. 스타는 관심도를 나타내며 품질을 보장하지 않습니다.
README.ko.md
Original100개 이상의 코딩 에이전트 팀을 오케스트레이션하는 멀티 디바이스 컨트롤 룸
휴대폰, 데스크톱, 브라우저에서.
Claude Code, Codex, OpenCode, Pi 등이 여러분의 머신에서 함께, 그리고 병렬로 작업합니다.
세션은 에이전트를 넘나들며 서브에이전트를 실행할 수 있습니다. 예를 들어 Claude가 Codex에게 리뷰를 요청하거나, Codex가 Claude 서브에이전트에게 작업을 위임할 수 있습니다. 세션 도중에 에이전트를 전환할 수도 있습니다. 어디에 있든 승인하고, 방향을 잡고, 리뷰하고, 커밋하세요.
오픈 소스 · 셀프 호스팅 가능 · 종단 간 암호화
English | 日本語 | 简体中文 | 한국어 | Español
시작하기 · 다운로드 · 문서 · 셀프 호스팅 · Discord
Happier는 무료 오픈 소스입니다.
이미 사용 중인 구독과 코딩 에이전트를 그대로 사용합니다.
기본 지원 에이전트 (그 외 30개 이상)
ACP를 지원하는 에이전트라면 무엇이든 설정에서 추가할 수 있습니다.
시작하기
1. 컴퓨터에 설치하기
데스크톱 앱으로 시작하는 것을 권장합니다. CLI와 데몬을 알아서 설정해 줍니다.
터미널이 더 편하신가요? 데스크톱 앱 없이 CLI와 데몬 설치하기
macOS/Linux:
curl -fsSL https://happier.dev/install | bash
Windows:
iwr https://happier.dev/install.ps1 -useb | iex
npm 패키지를 꼭 쓰고 싶다면: npm install -g @happier-dev/cli (CLI 문서).
원격 컴퓨터나 devbox에 설치하시나요? 내 머신에서 SSH로 설정하기
명령어 하나로 원격 호스트에 CLI와 데몬을 설치하고(릴리스 서명 검증 완료), 내 머신 중 하나로 등록합니다.
happier machine setup --ssh user@host
원격 머신에서 브라우저 없이 로그인하려면, 이미 로그인된 머신에서 다음을 실행하세요.
happier auth pair-remote --ssh user@host
원격 호스트에서 직접 헤드리스로 로그인할 수도 있습니다. happier auth login --no-open --method web을 실행하면 인증 URL이 출력되고, 아무 브라우저에서나 승인하면 됩니다. 머신과 데몬
로그인은 앱에서 하거나 처음 실행할 때 하면 됩니다.
2. 휴대폰 추가하기
|
|
|
APK 직접 다운로드 안정 버전 |
|
|
|
|
같은 계정으로 로그인하면 세션, 머신, 설정이 이미 준비되어 있습니다.
3. 세션 시작하기
앱에서 → 새 세션을 누르고 머신, 폴더, 에이전트를 선택하세요. 터미널은 필요 없습니다.
또는 터미널에서, 아무 프로젝트 폴더에서나:
happier # Claude Code
happier codex # Codex
happier opencode # OpenCode
어느 쪽이든 세션은 모든 기기에 동시에 나타납니다. 터미널에서 계속 입력하고, 휴대폰으로 진행 상황을 따라가며 승인하고, 브라우저에서 리뷰하세요. 다른 에이전트와 명령어는 happier --help에서 확인할 수 있습니다.
할 수 있는 일
📱 휴대폰, 데스크톱, 웹에서 에이전트 실행하기
지금 손에 든 기기에서 세션을 시작하고, 방향을 잡고, 리뷰하고, 승인하세요. 세션은 크로스 디바이스로 동작하므로 어디서든 같은 세션을 이어갈 수 있습니다. 머신에서 이미 실행 중인 Claude Code, Codex, OpenCode 세션도 마찬가지입니다. 세션 이어가기

🖥️ 여러 머신에 걸친 병렬 세션 오케스트레이션
원하는 만큼 세션을 실행하고, 세션마다 머신, 폴더, 에이전트, 모델을 고르세요. 어느 머신에서 실행되든 하나의 목록에서 모두 따라갈 수 있습니다. 세션 시작하기 · 머신과 데몬

🔄 세션 도중에 에이전트 전환하기
세션을 그 자리에서 Claude에서 Codex로, 또는 반대로 옮기세요. 세션의 ID, 기록, 설정은 그대로 유지되고, 넘겨받는 에이전트는 최근 대화의 요약을 받습니다. 다른 에이전트로 계속하기

🔔 내가 처리할 일을 모은 받은편지함
권한 요청, 에이전트의 질문, 읽지 않은 세션이 모든 세션과 머신에 걸쳐 하나의 알림 센터에 모입니다. 푸시 알림을 누르면 요청한 바로 그 세션이 열립니다. 받은편지함과 승인

📝 diff를 리뷰하고 코멘트 보내기
에이전트가 변경한 내용을 살펴보고, 수정이 필요한 줄을 정확히 표시하세요. 코멘트는 같은 세션이나 새 세션으로 바로 보낼 수 있습니다. 리뷰 코멘트

🌿 어떤 기기에서든 Git과 워크트리
스테이징, 커밋, 푸시, 브랜치 생성, 풀 리퀘스트 생성까지 앱을 떠나지 않고 할 수 있습니다. 로컬 또는 원격의 어떤 브랜치에서든 별도의 Git 워크트리로 세션을 시작하거나, 지금 있는 폴더에서 시작할 수 있습니다. Git · 새 세션 옵션

📬 큐에 넣고, 방향 잡기
에이전트가 작업하는 동안 메시지를 큐에 넣고, 실행되기 전에 순서를 바꾸거나 수정하세요. 실행 중인 턴을 중단하지 않고 방향을 잡을 수도 있습니다. 스티어링 · 대기 큐

🪪 구독, 계정 풀, 사용량 한도
같은 서비스에 대해 내가 가진 여러 계정을 연결하고 하나의 풀로 묶으세요. 자동 전환을 켜 두면 한 계정이 사용량 한도에 도달하거나 로그인이 만료될 때 풀이 세션을 다른 계정으로 옮겨 작업이 계속됩니다. 전환할 계정이 없으면 Claude 세션은 한도가 초기화될 때 자동으로 재개됩니다. 연결된 서비스와 풀 · 사용량 한도

📊 계정 사용량 확인하기
연결된 계정과 구독마다 얼마나 남았는지 확인하세요. Claude 구독이라면 5시간 한도와 주간 한도, 그리고 각각이 초기화되기까지 남은 시간을 볼 수 있습니다. 연결된 서비스

🤝 에이전트를 넘나드는 서브에이전트
세션은 다른 에이전트에게 작업을 넘길 수 있습니다. 예를 들어 Claude가 Codex에서 리뷰, 계획, 위임 실행을 시작하면, 세션의 에이전트 탭에서 모든 실행을 따라갈 수 있습니다. 위임된 작업

🗂️ 파일, 에디터, 터미널
어떤 기기에서든 세션 폴더의 파일을 탐색, 검색, 편집하세요. 간단한 명령이 필요할 때는 연결된 머신에서 터미널을 열 수 있습니다. 파일과 에디터 · 내장 터미널

⌨️ 터미널이 좋다면? 계속 쓰세요!
Claude Code, Codex, OpenCode를 각자의 터미널 UI에서 실행하세요. Happier가 그 세션을 모든 기기에 미러링하므로 어디서든 진행 상황을 따라가고, 메시지를 보내고, 승인할 수 있습니다. Claude 통합 터미널
🎙️ 음성
음성 어시스턴트는 실행 중인 세션을 따라가고, 나 대신 권한 요청에 응답하며, 받아쓴 메시지를 보냅니다. ElevenLabs 실시간 음성을 사용하거나, 온디바이스 음성 처리, OpenAI 호환 엔드포인트, Google Gemini와 Google Cloud, Kokoro로 로컬 파이프라인을 구성할 수 있습니다. 음성
그 밖의 기능
- 세션 핸드오프. 실행 중인 Claude Code 또는 OpenCode 세션을 다른 머신으로 옮기고, 원하면 작업 트리도 함께 가져갈 수 있습니다. 세션 핸드오프
- 세션 공유. 보기 또는 편집 권한으로 다른 사람을 초대하거나, 읽기 전용 공개 링크를 게시하세요. 세션 공유
- MCP 서버로서의 Happier.
happier mcp serve를 사용하면 어떤 MCP 호스트든 세션을 만들고, 메시지를 보내고, 세션 작업을 실행할 수 있습니다. MCP 서버로서의 Happier · CLI - MCP 서버는 한 번만 설정. 모든 머신의 모든 에이전트에서 사용할 수 있습니다. MCP 서버
- SSH로 머신 추가, 앱에서도 CLI에서도 가능합니다. 머신과 데몬
- 셀프 호스팅. 셀프 호스팅 릴레이에서도 같은 앱, 암호화, 기능이 동작합니다. 셀프 호스팅
- 종단 간 암호화. 콘텐츠는 기본적으로 내 기기에서 암호화됩니다. 보안
단계별 가이드는 guides.happier.dev에서 볼 수 있습니다.
Happier의 동작 방식
Phone Desktop Browser
│ │ │
└────────────────┼────────────────┘
│
▼
Happier relay (hosted or yours)
syncs end-to-end encrypted sessions
between your devices and machines
│
▼
Your machines (laptop, desktop, VPS, dev box)
the Happier daemon starts and manages
agent processes where your code lives
│
▼
Claude Code · Codex · OpenCode · Pi · ...
each agent talks to its own model
provider directly
릴레이는 자신이 읽을 수 없는 콘텐츠를 저장하고 전달합니다. 세션 콘텐츠는 서버에 도달하기 전에 내 기기에서 암호화됩니다. 서버는 세션 ID, 타임스탬프, 턴 상태, 사용량 메타데이터처럼 라우팅에 필요한 정보만 처리합니다. 에이전트는 계속해서 각자의 모델 제공업체와 직접 통신합니다.
셀프 호스팅
명령어 하나로 나만의 릴레이를 실행하세요.
happier relay host install --mode system
현재 머신에 관리형 릴레이 서비스를 설치하고 업데이트합니다. 원격 호스트라면: happier relay host install --ssh user@host --mode system.
자세한 내용은 셀프 호스팅 문서(happier.dev/self-host에서도 접근 가능)를 참고하세요. 대안으로 Docker와 Proxmox도 있습니다.
보안
- 콘텐츠는 기본적으로 종단 간 암호화됩니다. 코드, 프롬프트, 메시지, 대화 기록은 서버에 도달하기 전에 내 기기에서 암호화됩니다. 암호화
- 서버는 라우팅 메타데이터를 처리합니다. 기기 간 동기화를 위해 세션 ID, 타임스탬프, 턴 상태, 사용량 메타데이터는 릴레이가 볼 수 있습니다.
- 셀프 호스팅 운영자는 저장 정책을 선택할 수 있습니다. 셀프 호스팅 서버는 배포 환경에 맞게 다른 저장 정책으로 구성할 수 있습니다. 서버 암호화 설정
- 모델 트래픽은 에이전트가 직접 처리합니다. 각 에이전트는 자신의 모델 제공업체와 직접 통신합니다.
더 자세한 내용은 보안 문서를 참고하세요.
다운로드
| 플랫폼 | 받기 |
|---|---|
| iOS | App Store |
| Android | Google Play · APK |
| macOS · Windows · Linux (데스크톱 앱) | happier.dev/download · 모든 데스크톱 빌드 |
| Web | cloud.happier.dev |
| CLI (macOS, Linux) | curl -fsSL https://happier.dev/install | bash |
| CLI (Windows) | iwr https://happier.dev/install.ps1 -useb | iex |
릴리스 노트는 변경 내역에서 볼 수 있습니다.
릴리스 채널과 나이틀리 빌드
위의 방법은 모두 stable 채널을 설치합니다. 이보다 앞서 배포되는 채널이 두 개 더 있으며, 나란히 설치되므로(happier, hprev, hdev) 사용해 보더라도 stable 환경이 망가지지 않습니다.
- preview: 새 기능이 stable보다 먼저 이곳에 들어옵니다.
- dev: 최신 변경 사항을 담은 나이틀리 빌드입니다. 미완성 커밋이 포함될 수 있고 언제든 깨질 수 있습니다.
preview 또는 dev 빌드 설치하기
Preview (macOS/Linux, 그다음 Windows):
curl -fsSL https://happier.dev/install-preview | bash
iwr https://happier.dev/install-preview.ps1 -useb | iex
Dev:
curl -fsSL https://happier.dev/install-dev | bash
iwr https://happier.dev/install-dev.ps1 -useb | iex
그런 다음 happier 대신 hprev 또는 hdev 명령을 실행하세요. happier를 dev 레인에 연결하고 싶다면 .bashrc/.zshrc에 alias happier='hdev'를 추가하세요.
dev에서는 모든 구성 요소(CLI, 앱, 데몬, 서버)를 dev 릴리스로 실행해야 합니다. 호스팅 클라우드(cloud.happier.dev)는 stable로 운영되므로 preview와 dev 기능이 동작하지 않을 수 있고, dev에는 호스팅 웹 앱이 없습니다(dev 웹 UI를 쓰려면 dev 서버를 셀프 호스팅하세요).
모바일 및 서버 dev 빌드:
- iOS TestFlight
- Android dev APK
- 서버 이미지: Docker Hub
happierdev/relay-server:dev· GHCR - Dev box (CLI + 데몬 + 에이전트 사전 설치): Docker Hub
happierdev/dev-box:dev
채널이 릴리스 태그에 어떻게 대응하는지, 설치 방법별로 어떻게 업데이트되는지: docs.happier.dev/releases/updates.
커뮤니티와 기여
Happier는 공개적으로 개발되며, 실제 피드백을 통해 성장합니다. 무언가 고장 났거나, 빠져 있거나, 어색하게 느껴진다면 알려 주세요.
- 버그 (재현 단계와 함께): GitHub issues
- 아이디어와 설계 관련 질문: GitHub discussions
- 소식, 질문, 간단한 피드백: Discord
- 코드, 문서, 개발 환경 설정: CONTRIBUTING.md
명확한 이슈 하나가 풀 리퀘스트보다 더 가치 있는 경우가 많습니다. 무엇을 했는지, 무엇을 기대했는지, 실제로는 무슨 일이 일어났는지 적어 주세요.
왜 “Happier”인가요?
저희는 원래 Happy의 기여자로 시작해 수정 사항, 개선 사항, 새 기능을 업스트림에 제출했습니다.
업무에서 매일 사용했고, 그 콘셉트를 정말 좋아했습니다. 그러다 시간이 지나면서, 저희의 필요에는 메인 프로젝트 안에서 편하게 시도하기 어려운 더 빠른 반복이 필요하다는 것을 깨달았습니다.
그래서 저희가 쓸 것을 직접 만들기 시작했습니다.
몇 주에 걸쳐 기반을 다듬고, 고치고, 확장한 끝에 다른 사람들도 써 보고, 사용하고, 앞으로의 방향을 함께 만들어 갈 수 있도록 Happier를 공개하기로 했습니다.
Happier는 Happy가 마련해 준 기반에 깊이 감사하면서, 더 빠르게 움직이고 더 협력적인 방향을 탐색하는 프로젝트입니다. 저희는 Happy를 좋아했고, 지금도 좋아합니다. ❤️ Happy가 없었다면 Happier도 없었을 것입니다.
스위스에서 만들었습니다. MIT 라이선스.
Anthropic, OpenAI, Google과 제휴하거나 보증을 받지 않았습니다.