Gemini 需经 Antigravity 运行，OpenCode 和 ACP agent 需各自单独登录；多模型会话和团队协作要改用桌面版和 Happy Harness；包名已从 happy-coder 迁移为 happy
happy
slopusMIT活跃维护把 Claude、Codex、Grok 等多个编码 Agent 统一到一个应用里编排调度，并复用你已付费的订阅额度，省去多平台来回切换。
Orchestrate Claude, Codex and Grok in one app. Open-source (MIT), reuses the subscriptions you already pay for.
cli-1.2.5发布于 2026-09-22 10:11 UTC24,566star +35 / 7 天2,117fork同步于 2026-11-10 11:22 UTC
把 Claude、Codex、Grok 等模型编排进一个应用，复用你已付费的订阅
把 Claude、Codex、Grok 等多个编码 Agent 统一到一个应用里编排调度，并复用你已付费的订阅额度，省去多平台来回切换。
核心能力
- 统一编排 Claude、Codex、Grok、Gemini 等多模型
- 复用已付费的 Claude、Codex、Grok 订阅登录
- 端到端加密同步会话到手机端
- 支持多人加入同一会话共同操控 agent
- MIT 开源，可自托管、自行 fork 构建
容易踩的坑
内容由模型根据 README 生成，可能不完整或不准确，以官方文档为准。看原文 README
- cli-1.2.6-beta.1Happy CLI v1.2.6-beta.1pre-release2026-10-09 · 2026-10-09 08:00 UTC
查看更新说明
- Offline reconnect fix: a session started while the Happy server was unreachable now receives messages, Stop and kill from the app after it reconnects (acp, gemini, agy, openclaw). Thanks @rophy (#1858, fixes #1857).
- Agent SDK 0.3.295 (Claude Code 2.1.295): Sonnet 5.5 and Haiku 5.5 now get the full 1M context window, and
[1m]models no longer fail on gateways, Bedrock, Vertex or Foundry that refuse the context-1m beta. - Permission mode: when no permission mode is picked, Claude Code's own settings (
defaultMode) now decide, instead of always starting in manual approval.
- cli-1.2.6-beta.0Happy CLI v1.2.6-beta.0pre-release2026-10-09 · 2026-10-09 02:43 UTC
查看更新说明
Happy CLI v1.2.6-beta.0
- Opus 5.5 in app-started sessions: the Claude Agent SDK floor is raised to
^0.3.283(bundled Claude Code 2.1.283). Older bundled Claude Code (below 2.1.280) rejects Opus 5.5 with an API 400. (#1881) - Clearer error for an outdated bundled Claude Code: when Claude reports a model is too new for it, the session message now says to update Happy (
npm i -g happy@latest);claude updatedoes not replace the copy bundled with Happy. (#1881) - Session metadata parsing accepts the new optional
systemKeyanddepthfields from newer Happy Agents (happy-wire).
- Opus 5.5 in app-started sessions: the Claude Agent SDK floor is raised to
- cli-1.2.5Happy CLI v1.2.5最新正式版2026-09-22 · 2026-09-22 10:11 UTC
Happy CLI 1.2.5
Session reliability
- Preserve and recover resumable sessions after daemon state is lost.
- Prevent duplicate owners during concurrent or cancelled resumes.
- Recover transcripts that appear late or after watcher restart.
- Keep closed sessions closed.
Codex and Claude
- Remove the Codex turn timeout and preserve valid turn IDs for continued output and diffs.
- Improve expired Claude login diagnostics.
- Forward configured Claude plugin directories.
macOS
- Avoid reconnecting during dark wake while retaining compatibility fallbacks.
Shared runtime behavior
- Include message acceptance, queue metadata, and synchronized composer draft support.
- cli-1.2.5-beta.2Happy CLI v1.2.5-beta.2pre-release2026-09-20 · 2026-09-20 05:17 UTC
查看更新说明
Clearer provider sign-in errors
When a Claude provider login has expired, Happy now explains that authentication needs attention instead of leaving you with an unclear startup failure.
Remote Claude plugins
Plugin directories supplied to Claude are now carried through to remote sessions, so those sessions can use the same plugins as your local workflow.
Updated Happy Agent session metadata
The bundled session parser understands Happy Agent's synchronized composer drafts and last-used message mode, keeping the CLI's shared session metadata aligned with the new desktop and mobile preview experience.
This is a preview release published to the npm
betachannel; the stablelatestchannel is unchanged. - cli-1.2.5-beta.1Happy CLI v1.2.5-beta.1pre-release2026-09-14 · 2026-09-14 07:01 UTC
查看更新说明
Session reliability
- Prevent duplicate processes when resuming live or still-stopping sessions.
- Concurrent resumes share one attempt; cancelling a resume while it is preparing prevents it from launching.
Community credits
- Adapted from @chphch's single-flight resume and PID/boot-time approach in PR #1715.
用户点评
登录用户的真实使用记录，可按版本和硬件筛选共 0 条
还没有人点评。第一个说出真实体验的人最有价值。
https://github.com/user-attachments/assets/deeeeaf5-e550-49bc-829f-1186898f441a
What you get
- Any model: Claude, Codex, Grok, Gemini, and more. Gemini runs through Antigravity, and OpenCode or any Agent Client Protocol agent plugs in as a harness. Give every task the model that fits, and delegate to subagents on any of them.
- Reuse your subscriptions. Sign in with the Claude, Codex, and Grok subscriptions you already pay for; Antigravity, OpenCode, and ACP agents keep their own logins. Happy adds a harness, not another bill.
- Open source MIT. It runs on your own hardware and your projects stay ordinary folders. Read the code, fork it, ship your own build.
- End-to-end encrypted mobile app. Left your desk? The same sessions are already on your phone, and what moves between your devices is encrypted.
- Natively multiplayer. Invite a colleague or a friend into the session. You both watch the same agent work, and either of you can steer it.
Resources
How Happy fits together
| Repository | What it is |
|---|---|
| slopus/happy ← this repository | The mobile app (iOS, Android, web), the original CLI, and the relay server |
| slopus/happy-desktop | The desktop app for macOS, Windows, and Linux |
| slopus/happy-agent | Happy Agent, the open-source agent runtime the desktop app runs on |
| slopus/slopus.github.io | The website and docs at happy.engineering |
Original Happy CLI
The original CLI wraps the Claude Code and Codex harnesses directly in your terminal and lets you continue from your phone.
For multi-model sessions and teams, move to the desktop app and Happy Harness.
npm install -g happy
# Start Claude Code
happy claude
# Or start Codex
happy codex
- happy-ios: native Swift/UIKit iOS app
- happy-android: native Kotlin/Jetpack Compose Android app
- happy-i18n: shared JSON translations
- happy-cli: the original Happy CLI (
happyon npm) - happy-server: the relay server for encrypted sync
- happy-push-server: Cloudflare Worker that delivers push notifications via APNs/FCM (replaces the Expo push service)
Migrated from the happy-coder package. Thanks to @franciscop for donating the happy package name!