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!