Happier CLI与Daemon架构完整指南:本地如何管理多AI Agent进程
Happier CLI与Daemon架构完整指南:本地如何管理多AI Agent进程
Happier 是一款开源的多设备客户端与编排器,可以在你自己的电脑上同时运行 Claude Code、Codex、OpenCode、Pi 等 AI Agent,并通过 Web、桌面和手机统一管理。它的核心是一套「CLI + 本地 Daemon」架构:命令行工具 happier 负责人机交互,后台守护进程 Daemon 负责真正拉起并看护多个 AI Agent 进程。本文将带你快速理解这套本地多 AI Agent 进程管理方案 🚀
一、Happier CLI 与 Daemon 分别是什么?
Happier 的本地部分由两个角色组成,分工非常清晰:
- CLI(
happier命令):你与系统对话的入口。它解析子命令(如happier codex、happier session list)、处理登录认证,并决定是否把 Agent 放到前台直接运行、还是交给后台 Daemon 管理。 - Daemon(后台守护进程):一个长生命周期的本地进程,它是真正"干活"的那一层。它会:
- 启动并跟踪每一个 Agent 会话的子进程(Session 1、Session 2……Session N);
- 在本机启动一个只监听
127.0.0.1的本地控制服务器,供 CLI 通过 IPC 下发指令; - 向 Relay 服务器注册"这台机器",发送心跳,保持机器在线状态;
- 把会话状态同步到云端,让你的手机和浏览器能看到同一个会话。
这种"前台 CLI + 后台 Daemon"的拆分,正是能并行管理上百个 AI Agent 进程的基础:CLI 随时可以退出,而 Agent 进程仍在 Daemon 看护下稳定运行。
架构全貌可阅读官方文档 docs/cli-architecture.md,Daemon 源码位于 apps/cli/src/daemon/。
二、架构拆解:本地控制服务器是如何运作的?
2.1 本地控制服务器:Daemon 的"指挥中心"
Daemon 启动后会在本机回环地址上开一个 HTTP 控制服务器(见 controlServer.ts),对外只暴露几个关键接口:
| 接口 | 作用 |
|---|---|
/list |
列出当前活跃的所有 Agent 会话 |
/spawn-session |
让 Daemon 后台启动一个新会话 |
/stop-session |
停止指定会话的子进程 |
/stop |
关闭整个 Daemon |
/session-started |
会话子进程向 Daemon 自报身份 |
CLI 通过 controlClient.ts 与它通信,端口号记录在本地状态文件里。整个过程不经过公网——外部设备(手机、浏览器)无法直连你的电脑,它们只能通过端到端加密的 Relay 间接下发 RPC 指令,再由 Daemon 执行。
2.2 本地状态目录:~/.happier 里有什么?
Daemon 的所有本地状态都集中在 ~/.happier 目录(见 configuration.ts 与 persistence.ts):
settings.json:账号与配置信息;access.key:本地加密密钥材料;daemon.state.json:Daemon 的 PID、控制端口、版本——CLI 就是靠它找到正在运行的 Daemon;logs/:CLI 与 Daemon 的日志,排障时第一时间看这里。
每个会话子进程还会在 Daemon 的会话登记簿(sessionRegistry.ts)里留下带 PID 的标记文件,用于进程识别、防 PID 复用误杀,以及崩溃后恢复。
三、快速上手:3 步跑起你的第一个 Daemon
第 1 步:安装 CLI。 桌面应用会自动帮你装好 CLI 和 Daemon;喜欢终端的用户可以在 README.md 的 Get started 一节找到一键安装脚本(macOS/Linux 用 curl 脚本,Windows 用 PowerShell 脚本)。
第 2 步:登录。 在应用内或首次运行 happier 时按提示完成登录,CLI 会把这台电脑注册为 Relay 上的一台"机器"。
第 3 步:启动会话。 在任意项目目录执行:
happier # 默认启动 Claude Code 会话
happier codex # 启动 Codex 会话
happier opencode # 启动 OpenCode 会话
会话会同时出现在终端、桌面应用、浏览器和手机里。想安装后台自动启动服务(开机自启的 Daemon),只需一条命令:
happier service install
四、常用命令清单:像管进程组一样管理 AI Agent
日常运维 Daemon,只需要记住下面这张命令表(命令实现见 daemon.ts):
| 命令 | 说明 |
|---|---|
happier daemon start |
后台(分离模式)启动 Daemon |
happier daemon status |
查看 Daemon 运行状态 |
happier daemon status --all |
查看所有已配置 Relay 的 Daemon 状态 |
happier daemon list |
列出当前活跃的全部会话 |
happier daemon stop |
停止手动启动的 Daemon(可用 --all 停全部) |
happier daemon restart |
重启 Daemon(可保留会话) |
happier session list |
以会话视角查看各 Agent 进展 |
happier session send <id> "消息" |
向指定会话发指令,比如让它重跑失败的测试 |
happier doctor |
诊断本地环境;happier doctor clean 清理失控进程 |
配合 happier mcp serve,你还可以让外部 MCP 客户端直接驱动 Happier 的全部动作,把多 Agent 编排写进自己的自动化流水线 🛠️
五、多设备协作:一个电脑,多个 AI Agent 进程
5.1 手机上指挥"Agent 团队"
Daemon 支持后台批量拉起会话,每个会话可指定不同的机器、文件夹、Agent 和模型。手机推送会直接打开发出请求的那个会话,权限审批、消息追加、中途转向(steering)都能远端完成:
5.2 一键接管电脑上已有的 Agent 会话
如果你已经在终端里跑着 Claude Code 或 Codex,Happier 不需要迁移任何东西——Daemon 会把现有会话"收养"进来,之后所有设备实时可见(浏览逻辑见 existing-sessions 特性图 所示界面):
5.3 终端会话实时镜像到手机
在终端里跑 Claude Code,手机 App 同步显示工具调用、文件读取等每一步进展,随时从手机上补发消息或批准操作:
5.4 一台电脑服务多个 Relay
Happier 允许每个 Relay 各跑一个 Daemon:happier daemon status --all 可列出全部实例,互不干扰(多 Daemon 管理见 multiDaemon.ts)。工作 Relay 和个人 Relay 可以并存,用 --server <profile-id> 前缀即可指定操作哪一个。
六、安全设计:为什么放心把进程管理交给它?
- 端到端加密:代码、提示词、消息、会话记录都在你的设备上加密后才发往 Relay,服务器只处理会话 ID、时间戳等路由元数据(详见 docs/encryption.md);
- 本地控制服务器只听回环地址:外部设备无法绕过 Relay 直连你的 Daemon;
- 模型流量直达:每个 Agent 直接与其模型服务商通信,Happier 不经手模型调用;
- 进程身份校验:会话标记包含进程命令哈希与实例指纹,避免 PID 复用导致的误操作。
七、总结
Happier 的「CLI + Daemon」架构回答了本地管理多 AI Agent 进程的三个关键问题:谁来拉起进程(Daemon 的 /spawn-session)、谁来跟踪进程(会话登记簿 + 心跳)、谁能远程指挥(端到端加密 Relay + 本地 IPC 控制服务器)。对新手而言,只需记住:安装后 happier service install 装好后台服务,然后 happier daemon status / happier daemon list 就是你的多 Agent 进程控制台。想要深入源码,建议从 docs/cli-architecture.md 的架构图和 apps/cli/src/daemon/startDaemon.ts 的启动流程读起。



