Happy

Code on the go — control AI coding agents from your phone, browser, or terminal.

Free. Open source. Code anywhere.

Installation

npm install -g happy

Migrated from the happy-coder package. Thanks to @franciscop for donating the happy package name!

Usage

Claude Code (default)

happy
# or
happy claude

This will:

1. Start a Claude Code session
2. Display a QR code to connect from your mobile device or browser
3. Allow real-time session control — all communication is end-to-end encrypted
4. Start new sessions directly from your phone or web while your computer is online

More agents

happy codex
happy gemini
happy openclaw

# or any ACP-compatible CLI
happy acp opencode
happy acp -- custom-agent --flag

Daemon

The daemon is a background service that stays running on your machine. It lets you spawn and manage coding sessions remotely — from your phone or the web app — without needing an open terminal.

happy daemon start
happy daemon stop
happy daemon status
happy daemon list

The daemon starts automatically when you run happy, so you usually don't need to manage it manually.

Authentication

happy auth login
happy auth logout

Happy uses cryptographic key pairs for authentication — your private key stays on your machine. All session data is end-to-end encrypted before leaving your device.

To connect third-party agent APIs:

happy connect gemini
happy connect claude
happy connect codex
happy connect status

Commands

| Command | Description | |---------|-------------| | happy | Start Claude Code session (default) | | happy codex | Start Codex mode | | happy gemini | Start Gemini CLI session | | happy openclaw | Start OpenClaw session | | happy acp | Start any ACP-compatible agent | | happy resume <id> | Resume a previous session | | happy notify | Send push notification to your devices | | happy doctor | Diagnostics & troubleshooting |

Advanced

Environment Variables

| Variable | Description | |----------|-------------| | 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 | | HAPPY_EXPERIMENTAL | Enable experimental features |

Sandbox (experimental)

Happy can run agents inside an OS-level sandbox to restrict file system and network access.

happy sandbox configure
happy sandbox status
happy sandbox disable

Building from source

git clone https://github.com/slopus/happy
cd happy-cli
yarn install
yarn workspace happy cli --help

Requirements

• Node.js >= 20.0.0
• For Claude: claude CLI installed & logged in
• For Codex: codex CLI installed & logged in
• For Gemini: npm install -g @google/gemini-cli + happy connect gemini

License

MIT