# Happy — Mobile Client for Claude Code & Codex

> Happy is a mobile + web client for Claude Code and Codex with a CLI wrapper, enabling encrypted device handoff for long agent runs.

## Install

Copy the content below into your project:

## Quick Use

1. Install / set up:
   ```bash
   npm install -g happy
   ```
2. Start / smoke test:
   ```bash
   happy claude  # or: happy codex
   ```
3. Verify:
   - Start a session via `happy claude`, then confirm you can view the session from the mobile/web client and return control to the keyboard.

## Intro

Happy is a mobile + web client for Claude Code and Codex with a CLI wrapper, enabling encrypted device handoff for long agent runs.

- **Best for:** Developers who want to monitor or take over long agent runs from a phone
- **Works with:** Node.js + npm for the CLI wrapper; iOS/Android/Web clients as documented
- **Setup time:** 10 minutes

## Practical Notes

- Setup time ~10 minutes (install CLI + sign in on one client)
- Two measurable checks: 1 session started and 1 device handoff completed
- GitHub stars + forks (verified): see Source & Thanks

Remote control is valuable when agent runs are long and interrupt-prone:

- Use it for approvals (permissions, prompts, or tool confirmations) without staying at the desk.
- Keep sensitive repos on-device; review what data leaves the machine and how encryption keys are managed.
- Start with a low-risk project to validate handoff reliability.

If you're rolling this out to a team, define a policy: which repos are allowed, and what constitutes sensitive output that must not be viewed on mobile.

### FAQ

**Q: How do I install the CLI?**
A: Run `npm install -g happy` as shown in the README.

**Q: How do I start Claude Code or Codex?**
A: Use `happy claude` or `happy codex` as a wrapper.

**Q: What should I verify first?**
A: Confirm a full handoff: start on desktop, view/control from mobile/web, then switch back.

## Source & Thanks

> Source: https://github.com/slopus/happy
> License: MIT
> GitHub stars: 20,527 · forks: 1,689

---

<!-- ZH -->

## 快速使用

1. 安装 / 设置：
   ```bash
   npm install -g happy
   ```
2. 启动 / 冒烟测试：
   ```bash
   happy claude  # or: happy codex
   ```
3. 验证：
   - 用 `happy claude` 启动会话；确认你能在移动端/Web 客户端查看会话，并能切回键盘继续控制。

## 简介

Happy 提供移动端+Web 客户端，并配套 CLI 包装器（`npm i -g happy`），让你在电脑与手机间切换控制 Claude Code/Codex；同时强调端到端加密与可审计的开源实现。

- **适合谁：** 希望在外出时也能查看/接管长时间 agent 运行的开发者
- **可搭配：** CLI 侧需要 Node.js + npm；移动端/Web 客户端按文档使用
- **准备时间：** 10 分钟

## 实战建议

- 准备时间约 10 分钟（安装 CLI + 登录一个客户端）
- 两项可量化检查：启动 1 个会话，并完成 1 次设备切换（电脑↔手机）
- GitHub stars / forks（已核验）：见「来源与感谢」

远程控制的价值在于：agent 运行很长且容易被审批/确认打断。

- 用于随时处理权限审批/确认提示，而不必一直守在电脑前。
- 对敏感仓库先做数据流梳理：哪些内容会离开本机、密钥如何管理。
- 先用低风险项目验证设备切换稳定性。

团队推广时建议先定规则：允许哪些仓库、哪些输出属于敏感内容不应在移动端查看。

### FAQ

**CLI 怎么装？**
答：按 README：运行 `npm install -g happy`。

**怎么启动 Claude Code/Codex？**
答：用 `happy claude` 或 `happy codex` 作为 wrapper。

**优先验证什么？**
答：先验证完整切换链路：桌面启动 → 手机/Web 查看/控制 → 切回桌面。

## 来源与感谢

> Source: https://github.com/slopus/happy
> License: MIT
> GitHub stars: 20,527 · forks: 1,689


---
Source: https://tokrepo.com/en/workflows/happy-mobile-client-for-claude-code-codex
Author: Script Depot