The Happy Next CLI wraps your existing AI coding tools (Claude Code, Codex, Gemini CLI) and adds mobile access, real-time sync, and orchestration.

​
Requirements

​
Install

npm install -g happy-next-cli
Verify the installation: 
happy --version
# 0.2.3

​
First run

Navigate to a project directory and run: 
happy
This starts a Claude Code session (the default agent). On first run, Happy will:
  1. Generate an encryption key pair stored at ~/.happy/access.key
  2. Register your machine with the Happy server
  3. Start the daemon (background service) automatically
  4. Display a QR code for mobile app pairing
Keep your encryption key safe. The file ~/.happy/access.key is your identity and encryption key. If you lose it, you cannot decrypt your session history. Back it up.

​
Data directory

Happy stores its data at ~/.happy/:
FilePurpose
access.keyYour encryption private key
settings.jsonCLI configuration
daemon.state.jsonDaemon process info
logs/Session and daemon logs

​
Update

npm update -g happy-next-cli
Or use the built-in command: 
happy update

​
Uninstall

npm uninstall -g happy-next-cli
To also remove local data: 
rm -rf ~/.happy