Kirill Dubovitskiy
3884cb975a
fullPath from git status was repo-root-relative, causing broken navigation when session path differs from git root. Now resolves to absolute paths via `git rev-parse --show-toplevel`. File viewer diff also uses the absolute path so it works regardless of cwd. Generated with [Claude Code](https://claude.ai/code) via [Happy](https://happy.engineering) Co-Authored-By: Claude <noreply@anthropic.com> Co-Authored-By: Happy <yesreply@happy.engineering>
Mobile and Web Client for Claude Code & Codex
Use Claude Code or Codex from anywhere with end-to-end encryption.
Step 1: Download App
Step 2: Install CLI on your computer
npm install -g happy-coder
Run From Source (Repo Checkout)
# from repository root
yarn cli --help
yarn cli codex
Local Dev Environment (Full Stack)
Spin up an isolated local dev environment with server (PGlite), web app, and CLI — no Docker, no external databases.
# Create a new environment (allocates ports, runs migrations)
yarn env:new
# Start services in separate terminals:
yarn env:server # Terminal 1 — server
yarn env:web # Terminal 2 — web app
# CLI — works from any directory after sourcing:
source environments/data/envs/<name>/env.sh
happy
Each environment gets its own database, ports, config, and a copied lab-rat-todo-project. Run yarn env:list to see all environments.
Release (Maintainers)
# from repository root
yarn release
Step 3: Start using `happy` instead of `claude` or `codex`
# Instead of: claude
# Use: happy
happy
# Instead of: codex
# Use: happy codex
happy codex
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.