slopus / happy
Mobile and Web client for Codex and Claude Code, with realtime voice, encryption and fully featured
AI Architecture Analysis
This repository is indexed by RepoMind. By analyzing slopus/happy in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.
Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.
Repository Summary (README)
Preview📱 iOS App • 🤖 Android App • 🌐 Web App • 🎥 See a Demo • 📚 Documentation • 💬 Discord
</div> <img width="5178" height="2364" alt="github" src="/.github/header.png" /> <h3 align="center"> Step 1: Download App </h3> <div align="center"> <a href="https://apps.apple.com/us/app/happy-claude-code-client/id6748571505"><img width="135" height="39" alt="appstore" src="https://github.com/user-attachments/assets/45e31a11-cf6b-40a2-a083-6dc8d1f01291" /></a> <a href="https://play.google.com/store/apps/details?id=com.ex3ndr.happy"><img width="135" height="39" alt="googleplay" src="https://github.com/user-attachments/assets/acbba639-858f-4c74-85c7-92a4096efbf5" /></a> </div> <h3 align="center"> Step 2: Install CLI on your computer </h3>npm install -g happy-coder
<h3 align="center">
Run From Source (Repo Checkout)
</h3>
# from repository root
yarn cli --help
yarn cli codex
<h3 align="center">
Release (Maintainers)
</h3>
# from repository root
yarn release
<h3 align="center">
Step 3: Start using `happy` instead of `claude` or `codex`
</h3>
# Instead of: claude
# Use: happy
happy
# Instead of: codex
# Use: happy codex
happy codex
<div align="center"><img src="/.github/mascot.png" width="200" title="Happy Coder" alt="Happy Coder"/></div>
How does it work?
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.
🔥 Why Happy Coder?
- 📱 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
📦 Project Components
- Happy App - Web UI + mobile client (Expo)
- Happy CLI - Command-line interface for Claude Code and Codex
- Happy Agent - Remote agent control CLI (create, send, monitor sessions)
- Happy Server - Backend server for encrypted sync
🏠 Who We Are
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.
📚 Documentation & Contributing
- 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
License
MIT License - see LICENSE for details.