Skip to content

README.md

Latest commit

 

History

History
122 lines (87 loc) · 3.9 KB

README.md

File metadata and controls

122 lines (87 loc) · 3.9 KB

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

Repository Info

License

MIT