slopus /happy

Orchestrate Claude, Codex and Grok in one app. Open-source (MIT), reuses the subscriptions you already pay for.

★ 24,654⑂ 2,122👁 79⑃ 905● 1,076▤ 16
SwiftMITCreated 2025-07-18happy.engineering/
Download: Happy CLI v1.2.5cli-1.2.5 ↓1.2.52026-09-22
+13
Daily
+183
Weekly
24,654
stars
2,122
forks
79
watchers
905
prs
1,076
issues
16
releases

README

Happy Engineering

The fun way of making things :D



https://github.com/user-attachments/assets/deeeeaf5-e550-49bc-829f-1186898f441a






   


 What you get

1. 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.
2. 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.
3. Open source MIT. It runs on your own hardware and your projects stay
   ordinary folders. Read the code, fork it, ship your own build.
4. 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.
5. 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


Website · Documentation · Discord · Development guide · MIT License


 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.

sh
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 (happy on 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!

Top issues

Discussions

Latest release

Happy CLI v1.2.5 cli-1.2.5 2026-09-22
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 mes

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON