happy-coder
v0.12.0
Published
Mobile and Web client for Claude Code and Codex
Readme
Happy
Code on the go controlling claude code from your mobile device.
Free. Open source. Code anywhere.
Installation
npm install -g happy-coderUsage
happyThis will:
- Start a Claude Code session
- Display a QR code to connect from your mobile device
- Allow real-time session sharing between Claude Code and your mobile app
Commands
happy auth– Manage authenticationhappy codex– Start Codex modehappy connect– Store AI vendor API keys in Happy cloudhappy notify– Send a push notification to your deviceshappy daemon– Manage background servicehappy doctor– System diagnostics & troubleshooting
Options
-h, --help- Show help-v, --version- Show version-m, --model <model>- Claude model to use (default: sonnet)-p, --permission-mode <mode>- Permission mode: auto, default, or plan--claude-env KEY=VALUE- Set environment variable for Claude Code--claude-arg ARG- Pass additional argument to Claude CLI
Environment Variables
HAPPY_SERVER_URL- Custom server URL (default: https://api.cluster-fluster.com)HAPPY_WEBAPP_URL- Custom web app URL (default: https://app.happy.engineering)HAPPY_HOME_DIR- Custom home directory for Happy data (default: ~/.happy)HAPPY_DISABLE_CAFFEINATE- Disable macOS sleep prevention (set totrue,1, oryes)HAPPY_EXPERIMENTAL- Enable experimental features (set totrue,1, oryes)
Requirements
- Node.js >= 20.0.0
- Required by
[email protected], which is required by@modelcontextprotocol/sdk, which we used to implement permission forwarding to mobile app
- Required by
- Claude CLI installed & logged in (
claudecommand available in PATH)
License
MIT
