Happier는 휴대폰, 데스크톱, 웹에서 Claude Code, Codex 등 여러 에이전트를 크로스 디바이스로 실행하고 오케스트레이션할 수 있는 오픈 소스 앱입니다. 세션은 신뢰하는 머신(노트북, 서버, 개발 서버)에서 실행되고, 휴대폰으로는 워크플로가 멈추지 않도록 관리합니다. 세션 시작, 후속 지시, 요청 승인, 필요하면 변경 사항 검토와 편집까지 원격 데스크톱을 열지 않고 처리합니다.

목표는 단순합니다.

휴대폰에서 세션을 시작하고, 신뢰하는 머신에서 계속 실행되게 둔 다음, 나중에 데스크톱이나 CLI에서 같은 세션으로 돌아오기.

Happier가 잘하는 부분이 바로 이것입니다. "진행 상황 확인 / 후속 지시 보내기 / 승인 처리" 루프는 휴대폰에서 하고, 세션은 머신(노트북, 서버, 개발 서버)에 그대로 남아 있습니다.

요약

1. 신뢰하는 머신에 Happier를 설정하고 휴대폰을 연결합니다. (처음이라면 GitHub의 "How it works" 섹션을 먼저 읽고 이 가이드로 돌아오세요.)
2. 휴대폰에서 세션을 시작(또는 열기)하고, 실행할 머신을 선택합니다.
3. 자리를 비운 동안 그 머신에서 계속 실행되게 둡니다.
4. 나중에 세션을 소유한 머신의 CLI에서 같은 세션을 이어갑니다.
   • 아직 실행 중이면 happier attach <session-id>
   • 비활성 상태이고 벤더 측 재개를 지원하면 happier resume <session-id>

"휴대폰에서 실행한다"는 것의 실제 의미

무거운 작업을 하는 곳은 휴대폰이 아닙니다. 휴대폰에서 하는 일은 다음과 같습니다.

• 에이전트가 무엇을 하는지 읽기
• 새 지시 보내기
• 가끔 나오는 프롬프트나 작업 승인하기
• 파일과 diff를 살펴보고 세션을 계속 진행시키기

실제 세션은 저장소와 도구가 있는 곳, 즉 노트북, 서버, 개발 서버에서 계속 실행됩니다.

중요한 점이 하나 있습니다. Happier는 "모바일 전용" 제품이 아닙니다. 휴대폰은 여러 화면 중 하나일 뿐입니다. 같은 세션을 데스크톱 웹, 데스크톱 앱, 또는 세션을 소유한 머신의 CLI에서도 이어갈 수 있습니다.

흔한 방법과 트레이드오프

흔히 쓰는 방법들:

• SSH + tmux: 괜찮은 방법이지만, 휴대폰에서는 긴 출력을 훑다가 맥락을 놓치고 "작은 터미널 작업"을 너무 많이 하게 됩니다.
• 원격 데스크톱: 데스크톱 도구가 필요할 때는 괜찮지만, 모바일에서는 무겁고 조작이 번거롭습니다.

더 잘 맞는 것은 세션은 내 머신에서 실행하면서, 휴대폰에 맞게 설계된 화면입니다.

• Happier: 세션을 내 머신에 둔 채로 세션 시작, 후속 지시, 승인 처리를 할 수 있는 휴대폰 친화적인 방법입니다. 트레이드오프: 세션을 소유한 머신이 온라인 상태로 연결되어 있어야 합니다.

tmux가 이미 워크플로에 잘 맞는다면 계속 쓰세요. Happier는 "진행 상황 확인 / 후속 지시 하나 / 승인 처리" 루프를 휴대폰에서 더 편하게 하는 방법을 더해 줍니다.

방법 A: 서버가 제공하는 웹 UI 사용 (셀프 호스팅 시 권장)

셀프 호스팅 중이거나 커스텀 Relay를 사용한다면, UI용으로 접속 가능한 HTTPS URL을 준비하세요 (예: Tailscale Serve를 통한 *.ts.net URL).

이유: 브라우저는 http://localhost를 보안 컨텍스트로 취급하지만, 임의의 LAN이나 Tailscale HTTP 오리진은 그렇게 취급하지 않습니다. Happier는 보안 컨텍스트가 필요한 브라우저 기능에 의존합니다.

방법 B: 네이티브 모바일 앱 사용

모바일 앱을 사용할 때 중요한 것은 세 가지입니다.

1. 올바른 Relay 선택 (Happier Cloud 또는 셀프 호스팅한 Relay)
2. 해당 Relay에 로그인
3. 머신(데몬)이 같은 Relay에 연결되어 있는지 확인

Happier를 처음 사용한다면 (무엇이고 어디서 받는지)

핵심은 휴대폰에서 하는 부분(후속 지시, 승인, 간단한 확인)을 SSH에 붙어 있지 않고 Happier로 처리하는 것입니다.

Happier는 AI 코딩 에이전트를 위한 오픈 소스 컴패니언 앱(모바일 / 웹 / 데스크톱)입니다. 세션은 신뢰하는 머신(노트북 / 서버 / 개발 서버)에서 계속 실행되고, Happier는 휴대폰에서 워크플로를 진행하는 곳입니다.

시작하기:

• 휴대폰에서 Happier 사용하는 방법
• GitHub: https://github.com/happier-dev/happier
• 설치 / 다운로드: https://github.com/happier-dev/happier#how-it-works
• Discord (커뮤니티 + 지원): https://discord.gg/W6Pb8KuHfg

휴대폰에서 시작하기

모바일(앱 또는 웹 UI)에서:

1. 새 세션을 만들고 실행할 머신을 선택합니다.
2. 작업을 보냅니다.
3. 터미널을 떠나 있는 동안 계속 실행되게 둡니다.

세션을 소유한 머신의 CLI에서 이어가기

세션을 소유한 머신에서:

세션이 아직 실행 중인 경우

attach를 사용합니다.

happier attach <session-id>

세션이 비활성 상태인 경우

resume을 사용합니다 (세션이 벤더 측 재개를 지원할 때만 동작합니다).

happier resume <session-id>

문제 해결

모바일 웹 UI는 열리지만 연결되지 않거나 "wrong Relay"가 표시됨

다음을 확인하세요.

• UI가 데몬(머신)과 같은 Relay를 가리키고 있는지
• 그 Relay에서 같은 계정으로 로그인했는지
• 셀프 호스팅이라면, 연 URL이 HTTPS인지 (LAN이나 Tailscale을 통한 일반 HTTP가 아닌지)