Skip to main content

​
What is Happy?

Happy is a mobile and web client for Claude Code and Codex that lets you control AI coding agents from anywhere. Use Claude Code from your phone, get push notifications when permissions are needed, and switch between devices instantly—all with end-to-end encryption.
1
Install the CLI
2
Install Happy globally using npm:
3
npm
npm install -g happy-coder
yarn
yarn global add happy-coder
pnpm
pnpm add -g happy-coder
4
Happy requires Node.js 20.0.0 or higher and the Claude CLI installed and logged in.
5
Verify Installation
6
Check that Happy is installed correctly:
7
happy --version
8
You should see the Happy version number followed by the Claude CLI version.
9
Download the Mobile App
10
Get the Happy app for your mobile device:
11
  • iOS: Download from App Store
  • Android: Download from Google Play
  • Web: Open Web App
    • 12
    Authenticate
    13
    Run your first Happy session and authenticate:
    14
    happy
    15
    On first run, you’ll be prompted to choose an authentication method:
    16
  • Mobile App: Scan the QR code with your Happy mobile app
  • Web Browser: Open the authentication URL in your browser
    • 17
    Once authenticated, Happy will start a Claude Code session.
    18
    Authentication credentials are stored securely in ~/.happy/access.key and automatically used for future sessions.
    19
    Start Your First Session
    20
    After authentication, Happy automatically starts Claude Code. You can now:
    21
  • Work locally: Type in your terminal as you normally would with Claude
  • Control remotely: Open the Happy app to view and control the session from your mobile device
  • Switch seamlessly: Press any key in your terminal to take back control from mobile
    • 22
    # Start a regular Claude session
happy

# Start with a specific prompt
happy "help me refactor this component"

# Resume a previous session
happy --resume
    23
    Try Different Modes
    24
    Happy supports multiple AI coding agents:
    25
    Claude (default)
    happy
    Codex
    happy codex
    Gemini
    happy gemini

    ​
    What’s Next?

    You’re now ready to use Happy! Here are some next steps:

    Installation Details

    Learn about system requirements and platform-specific setup

    Authentication

    Manage authentication and connect multiple devices

    Architecture

    Understand how Happy works under the hood

    CLI Reference

    Explore all available commands and options

    ​
    Common Use Cases

    Start a Claude session on your computer with happy, then check progress from your phone using the Happy app. You’ll get push notifications when Claude needs permissions or encounters errors.
    When Claude Code requests permission to run commands or modify files, approve or deny them directly from your mobile device without returning to your computer.
    Start coding on your desktop, continue reviewing on your phone during lunch, and resume on your laptop—all in the same session with complete context preservation.
    Manage multiple coding sessions through the Happy daemon, monitoring progress across different projects from a single mobile interface.

    ​
    Quick Tips

    Use happy --yolo as a shortcut for --dangerously-skip-permissions when you want Claude to work autonomously.
    Happy passes through all Claude CLI flags. Any option that works with claude also works with happy.
    The Happy daemon runs in the background and manages sessions. It starts automatically when you run happy for the first time.

    ​
    Need Help?

    If you encounter issues: 
    # Run diagnostics
happy doctor

# Check daemon status
happy daemon status

# View daemon logs
happy daemon logs

# Clean up runaway processes
happy doctor clean
    For more help, visit our Discord community or check the Documentation.

    Build docs developers (and LLMs) love

    Get started for freeTalk to us