Happy - Claude Code Mobile Client
happy.engineering- Category
- Developer Tools
- Rank
- No. 111Tools index
- Pricing
- Open Source
- Platform
- cli · mobile · web
- Type
- APP
- Builder
- @slopus
- GitHub
- 23.8k stars
- Latest release
- cli-1.2.3
- Date
About
A free, open-source mobile app that lets you control Claude AI coding sessions from your phone with voice commands, real-time sync, and end-to-end encryption. Run multiple Claude Code instances simultaneously across different devices while maintaining your existing development workflow.
What it does
Happy inserts a wrapper between local coding agents and remote clients. Start a Claude Code or Codex session through that wrapper, inspect it from the mobile or web interface, then regain desktop control with a keyboard press. A companion agent CLI can also create, resume, monitor, and message sessions.
Why it's ranked here
The project offers more than a phone viewer. It combines device handoff, permission and error notifications, encrypted synchronization, remote session management, and self-hostable server code. Support for both Claude Code and Codex broadens its value, while the published clients and global package provide a clear route to adoption.
What's good
Desktop control returns with one keypress, which keeps handoff simple. Push notifications surface permission requests and failures when users leave their desks. The repository separates clients, session protocols, command-line tools, and backend services. It also claims no telemetry or tracking, uses end-to-end encryption, and publishes the code under MIT.
Tradeoffs
Happy adds several moving parts: a globally installed wrapper, a client application, authentication, and an encrypted synchronization backend. Sessions must start through Happy rather than directly through the underlying coding agent. Moving control to the phone restarts the session in remote mode. The supplied code also exposes substantial server and daemon machinery that operators must understand when self-hosting.
How to use it well
It best suits developers who already run Claude Code or Codex locally and need to check progress, approve requests, or recover control while away. Use the mobile client for short supervision and return to the desktop for sustained coding. The tool coordinates existing agents; it does not supply the coding model or replace a full development environment.
Technical notes+
The private pnpm workspace in package.json includes app, CLI, agent, server, self-hosting, wire protocol, logging, and Codium packages. packages/happy-app/index.ts boots Expo Router, while packages/happy-app/src-tauri/src/lib.rs provides a Tauri entry point. packages/happy-cli/src/index.ts implements direct argument parsing for agent, daemon, authentication, sandbox, server, doctor, and resume operations; packages/happy-cli/src/lib.ts separately exports API clients, configuration, logging, and schemas. packages/happy-agent/src/index.ts uses Commander for machine and session control, including JSON output, spawning, status, and resume. packages/happy-wire/src/index.ts re-exports message, session, control, voice, and rig metadata protocols. packages/happy-server/sources/index.ts exposes startServer with embedded PGlite configuration, while packages/happy-server/sources/main.ts starts the standalone API, metrics, presence, authentication, encryption, database, and shutdown lifecycle.
Observed
- License
- MIT License
- Primary language
- TypeScript across the supplied app, CLI, agent, wire, logging, and server sources
- Install surface
- Global npm package named happy, with a pnpm workspace for repository development
- User interfaces
- iOS app, Android app, web app, main CLI, and remote agent CLI
- Agent support
- The main documentation describes Claude Code and Codex support
- Repository structure
- Monorepo separates app, CLI, remote agent, synchronization server, self-host server, wire protocol, logs, and Codium packages
- Server interface
- Standalone backend plus an exported embedded server startup API
- Desktop packaging
- The app includes a Tauri Rust entry point, and Codium contains an Electron-oriented React interface
Read from README.md, package.json, packages/happy-app/index.ts, packages/happy-cli/src/lib.ts, packages/happy-cli/src/index.ts, packages/codium/sources/main.tsx, packages/happy-wire/src/index.ts, packages/happy-agent/src/index.ts, packages/happy-app-logs/src/server.ts, packages/happy-server/sources/main.ts, packages/happy-server/sources/index.ts, packages/happy-cli/demo-project/main.go, packages/happy-cli/src/agent/index.ts, packages/codium/sources/theme/index.ts, packages/happy-app/src-tauri/src/lib.rs.
What it can do
Control Claude AI coding sessions with voice commands
Voice commands → Executed coding actions in Claude AI
Run multiple Claude Code instances simultaneously
Multiple coding project requests → Concurrent Claude Code sessions
Sync coding sessions in real-time across devices
Coding session data from multiple devices → Synchronized coding workspace state
Encrypt coding session communications end-to-end
Coding session data and commands → Encrypted communication channels
Maintain existing development workflow integration
Current development environment setup → Preserved workflow with mobile control capabilities
Tags
Tech Stack
Media
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.