npm install -g happy-coder

Or install from source:

git clone https://github.com/slopus/happy.git
cd happy
yarn install
cd packages/happy-cli
yarn build
npm link

# Instead of: claude
# Use: happy

happy

# Instead of: codex
# Use: happy codex

happy codex

On your computer, run happy instead of claude or happy codex instead of codex to start your AI through our wrapper. When you want to control your coding agent from your phone, it restarts the session in remote mode. To switch back to your computer, just press any key on your keyboard.

• 📱 Mobile access to Claude Code and Codex - Check what your AI is building while away from your desk
• 🔔 Push notifications - Get alerted when Claude Code and Codex needs permission or encounters errors
• ⚡ Switch devices instantly - Take control from phone or desktop with one keypress
• 🔐 End-to-end encrypted - Your code never leaves your devices unencrypted
• 🛠️ Open source - Audit the code yourself. No telemetry, no tracking

• Happy App - Web UI + mobile client (Expo)
• Happy CLI - Command-line interface for Claude Code and Codex
• Happy Server - Backend server for encrypted sync

We're engineers scattered across Bay Area coffee shops and hacker houses, constantly checking how our AI coding agents are progressing on our pet projects during lunch breaks. Happy Coder was born from the frustration of not being able to peek at our AI coding tools building our side hustles while we're away from our keyboards. We believe the best tools come from scratching your own itch and sharing with the community.

You don't need to self-host! Our free cloud Happy Server at happy-api.slopus.com is just as secure as running your own. Since all data is end-to-end encrypted before it reaches our servers, we literally cannot read your messages even if we wanted to. The encryption happens on your device, and only you have the keys.

That said, Happy Server is open source and self-hostable if you prefer running your own infrastructure. The security model is identical whether you use our servers or your own.

git clone https://github.com/slopus/happy.git
cd happy/packages/happy-server/deploy
cp .env.example .env   # Edit with your values
docker compose up -d

• CLI: HAPPY_SERVER_URL=https://happy-api.example.com happy
• Mobile: Tap server icon on login screen to change server

Prerequisites:

• For iOS: Xcode, Apple Developer account
• For Android: Android Studio with SDK

Build and install:

cd packages/happy-app
yarn install
yarn prebuild

# iOS
yarn ios:dev                # Simulator
yarn ios:connected-device   # Physical device via USB

# Android
yarn android:dev            # Emulator or connected device

Android Wireless Debugging:

# On your phone: Settings > Developer options > Wireless debugging > Pair device
adb pair <IP>:<PAIRING_PORT> <PAIRING_CODE>
adb connect <IP>:<CONNECTION_PORT>
yarn android:dev

Build Variants:

• Documentation Website - Learn how to use Happy Coder effectively
• CONTRIBUTING.md - Development setup including iOS, Android, and macOS desktop variant builds
• Edit docs at github.com/slopus/slopus.github.io - Help improve our documentation and guides

MIT License - see LICENSE for details.