Happy AI Agent

<div align="center"> <h1>Happy Engineering</h1> <p>The fun way of making things :D</p> </div>

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

<p align="center"> <a href="https://happy.engineering/#download"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/slopus/happy-desktop/main/.github/download-desktop-dark.svg"><img width="212" height="39" alt="Download Desktop for macOS, Windows, and Linux" src="https://raw.githubusercontent.com/slopus/happy-desktop/main/.github/download-desktop-light.svg" /></picture></a> </p> <p align="center"> <a href="https://apps.apple.com/us/app/happy-codex-claude-code-app/id6748571505"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/slopus/happy-desktop/main/.github/app-store-rating-dark.svg"><img width="150" height="56" alt="Download on the App Store. Rated 4.9 stars from 1,000+ ratings" src="https://raw.githubusercontent.com/slopus/happy-desktop/main/.github/app-store-rating-light.svg" /></picture></a>&nbsp;&nbsp;&nbsp;<a href="https://play.google.com/store/apps/details?id=com.ex3ndr.happy"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/slopus/happy-desktop/main/.github/google-play-rating-dark.svg"><img width="150" height="56" alt="Get it on Google Play. Rated 5.0 stars from 3.1k+ reviews" src="https://raw.githubusercontent.com/slopus/happy-desktop/main/.github/google-play-rating-light.svg" /></picture></a> </p>

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

<p align="center"> <a href="https://happy.engineering/">Website</a> · <a href="https://happy.engineering/welcome/">Documentation</a> · <a href="https://discord.gg/fX9WBAhyfD">Discord</a> · <a href="docs/CONTRIBUTING.md">Development guide</a> · <a href="LICENSE">MIT License</a> </p>

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 (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!