happier-dev/happier
happier-dev/happier has 2,166 GitHub stars and 221 forks. GitHot measured +5 stars in 24 hours. Last checked 2026-11-07 22:58 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
实测星标增长
- 24小时
- +5
- 7天
- 正在收集历史
- 15天
- 正在收集历史
- 1个月
- 正在收集历史
各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。
README.zh-CN.md
原文多设备控制中心,编排由 100+ 个编程代理组成的团队
在手机、桌面端和浏览器上都能用。
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 和 worktree
暂存、提交、推送、创建分支和发起拉取请求,都不用离开应用。可以基于任意本地或远程分支,在独立的 Git worktree 中开始会话,也可以直接在当前文件夹中开始。Git · 新会话选项

📬 排队发送,随时引导
代理工作时可以把消息加入队列,并在执行前调整顺序或编辑。也可以在不打断当前轮次的情况下引导它。引导 · 待发送队列

🪪 订阅、账号池和用量限制
为同一项服务连接你拥有的多个账号,并把它们组成一个池。开启自动切换后,当某个账号达到用量限制或登录过期时,池会把会话转到另一个账号,工作不会中断。如果没有可切换的账号,Claude 会话会在限额重置后自动恢复。已连接服务与账号池 · 用量限制

📊 查看各账号用量
查看每个已连接账号和订阅还剩多少额度。对于 Claude 订阅,会显示 5 小时限额和每周限额,以及各自距离重置的时间。已连接服务

🤝 跨代理的子代理
一个会话可以把工作交给另一个代理。例如 Claude 可以在 Codex 上发起审查、规划或委派任务,你可以在会话的“代理”标签页中跟进每一次运行。委派的工作

🗂️ 文件、编辑器和终端
在任意设备上浏览、搜索和编辑会话文件夹中的文件。需要快速执行命令时,可以在已连接的机器上打开终端。文件与编辑器 · 内嵌终端

⌨️ 喜欢终端?那就继续用!
在 Claude Code、Codex 或 OpenCode 各自的终端界面中运行它们。Happier 会把这些会话同步镜像到每台设备,让你随时随地跟进、发消息和审批。Claude 统一终端
🎙️ 语音
语音助手会跟进你正在运行的会话,替你回应权限请求,并发送你口述的消息。可以使用 ElevenLabs 实时语音,也可以用端侧语音、OpenAI 兼容端点、Google Gemini 和 Google Cloud 或 Kokoro 搭建本地流水线。语音
更多功能
- 会话移交。 把正在运行的 Claude Code 或 OpenCode 会话转移到另一台机器,需要的话可以连同工作树一起带过去。会话移交
- 会话共享。 邀请他人以查看或编辑权限加入,或发布一个只读的公开链接。会话共享
- 把 Happier 用作 MCP 服务器。
happier mcp serve让任意 MCP 宿主都能创建会话、发送消息和执行会话操作。把 Happier 用作 MCP 服务器 · 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
之后用 hprev 或 hdev 代替 happier。如果想让 happier 指向 dev 通道,可以在 .bashrc/.zshrc 中加入 alias happier='hdev'。
使用 dev 时,所有组件都必须来自 dev 版本(CLI、应用、守护进程和服务器):托管云服务(cloud.happier.dev)运行的是 stable,因此 preview 和 dev 的功能在上面可能无法使用;而且 dev 没有托管的 Web 应用(要使用 dev 版 Web 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 以开放的方式开发,靠真实的反馈不断成长。如果你觉得有什么地方坏了、缺了或者用着别扭,欢迎告诉我们。
- Bug(请附复现步骤):GitHub issues
- 想法和设计问题:GitHub discussions
- 新闻、提问和快速反馈:Discord
- 代码、文档和开发环境配置:CONTRIBUTING.md
一个清晰的 issue 往往比一个拉取请求更有价值:说明你做了什么、预期是什么、实际发生了什么。
为什么叫“Happier”?
我们最初是 Happy 的贡献者,向上游提交修复、改进和新功能。
我们每天都在工作中使用它,也是真心喜欢这个理念。 后来我们逐渐意识到,自己的需求需要更快的迭代,而这在主项目中很难放开手脚去尝试。
于是我们开始为自己构建这些功能。
经过数周的打磨、修复和对基础的扩展,我们决定把 Happier 分享出来,让更多人可以试用、使用,并一起决定它接下来的方向。
Happier 想探索一个迭代更快、协作更多的方向,同时由衷感谢 Happy 打下的基础。我们曾经喜欢、现在也依然喜欢 Happy。❤️ 没有它,就没有 Happier。
在瑞士开发。采用 MIT 许可证。
与 Anthropic、OpenAI 或 Google 无关联,也未获其背书。