​
Prerequisites

  • Node.js 20+ installed on your development machine
  • Claude Code, Codex, or Gemini CLI installed (at least one)
  • A phone with the Happy Next app installed (iOS (TestFlight) / Android (APK))

​
Step 1: Install the CLI

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

​
Step 2: Start a session

Start a Claude Code session (the default): 
happy
You can also start Codex or Gemini sessions:
happy codex    # Start an OpenAI Codex session
happy gemini   # Start a Google Gemini session
On first run, Happy will display a QR code in your terminal.

​
Step 3: Pair your phone

  1. Open the Happy app on your phone
  2. Tap the scan icon on the home screen
  3. Scan the QR code displayed in your terminal
Your phone is now connected to your AI coding session.

​
Step 4: Send a message from your phone

Open the session in the Happy app and type a message — for example:
List all files in the current directory
You’ll see the AI agent execute the command in your terminal, and the response will appear on your phone in real time.

​
What’s next?

Core Concepts

Understand how sessions, machines, and agents work together.

CLI Configuration

Learn about models, permissions, and environment variables.

Orchestrator

Dispatch multi-agent workflows.

Voice Control

Talk to your AI agent instead of typing.