Happy CLI Next - Preview Fork

Code on the go controlling Claude Code from your mobile device.

Free. Open source. Code anywhere.

This is a preview fork with experimental features and improvements. For the stable version, see slopus/happy-cli.

Quick Install

npm install -g happy-next

This installs as happy-next so it won't conflict with the stable happy version.

Preview versions (auto-published on every commit):

npm install -g happy-next@preview  # Latest preview - auto-updates on every push!

Every push to the preview branch automatically publishes to npm with a unique version like 1.0.0-preview.20251118120000.abc1234

📖 Complete Installation Guide - Side-by-side setup, troubleshooting, etc.

What's New in This Fork

🔧 Codex Integration Fixes

• Fixed race conditions in WebSocket connections
• Added subprocess health monitoring and auto-recovery
• Windows console window fixes
• Permission handling with timeouts
• Improved error recovery and reconnection logic

📦 Installation & Publishing Improvements

• Automatic preview publishing - Every push publishes to npm as @preview tag
• Automatic dist building via GitHub Actions on every commit
• Cross-platform CI testing (Windows, macOS, Linux)
• No manual publishing needed - just push your changes!

🔄 Upstream Sync

• Automated daily sync from upstream (slopus/happy-cli)
• Manual sync: ./scripts/sync-upstream.sh
• Auto-merges when no conflicts

Usage

happy-next

This will:

1. Start a Claude Code session
2. Display a QR code to connect from your mobile device
3. Allow real-time session sharing between Claude Code and your mobile app

Commands

• happy-next auth – Manage authentication
• happy-next codex – Start Codex mode
• happy-next connect – Store AI vendor API keys in Happy cloud
• happy-next notify – Send a push notification to your devices
• happy-next daemon – Manage background service
• happy-next 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 to true, 1, or yes)
• HAPPY_EXPERIMENTAL - Enable experimental features (set to true, 1, or yes)

Side-by-Side with Stable

Run both versions simultaneously:

# Install stable
npm install -g github:slopus/happy-cli

# Install preview
npm install -g github:jakenuts/happy-cli#latest-preview

# Use either
happy --version           # Stable
happy-next --version      # Preview

Both share the same config directory (~/.happy-dev/) but use different command names.

Requirements

• Node.js >= 20.0.0
• Claude CLI installed & logged in (claude command available in PATH)
• Claude Code SDK: Pinned to 2.0.24 (last version with SDK exports)

Documentation

• 📦 Installation Guide - Complete setup instructions
• 🔧 Scripts Documentation - Testing, publishing, syncing
• 📚 Codebase Overview - Architecture and code style
• 🏗️ Technical Details - Deep dive into implementation

Repository Info

• Fork (active): https://github.com/jakenuts/happy-cli
• Upstream: https://github.com/slopus/happy-cli
• Server: https://api.happy-servers.com/

License

MIT