Summary

Happy CLI provides a free, open-source command-line interface for remotely controlling a local Claude Code session from a mobile device. It targets developers aiming to code flexibly from anywhere, offering real-time session sharing and control, thereby enhancing productivity and accessibility.

How It Works

The tool initiates a local Claude Code session and presents a QR code for mobile app synchronization. It facilitates real-time sharing and control between the desktop environment and the mobile application, likely leveraging a cloud-based backend for communication and state management.

Quick Start & Requirements

• Install: npm install -g happy-coder
• Prerequisites: Node.js version 20.0.0 or higher. Claude CLI installed and authenticated (claude command available in PATH).
• Links:
  • Server URL: https://api.cluster-fluster.com (customizable via HAPPY_SERVER_URL)
  • Web App URL: https://app.happy.engineering (customizable via HAPPY_WEBAPP_URL)

Highlighted Details

• Core command happy starts the session, displays QR code, and enables mobile connection.
• Includes commands for authentication (happy auth), Codex mode (happy codex), API key management (happy connect), push notifications (happy notify), daemon management (happy daemon), and diagnostics (happy doctor).
• Supports specifying Claude models (-m) and permission modes (-p).
• Environment variables allow customization of server URLs, home directory, and disabling macOS sleep prevention (HAPPY_DISABLE_CAFFEINATE).

Maintenance & Community

No specific information regarding maintainers, community channels (like Discord/Slack), or project roadmap was provided in the README.

Licensing & Compatibility

• License: MIT.
• Compatibility: The MIT license is permissive and generally compatible with commercial use and linking within closed-source projects.

Limitations & Caveats

The tool requires both Node.js and the Claude CLI to be installed and configured. Functionality is dependent on the availability and stability of the api.cluster-fluster.com backend service. Experimental features are noted, suggesting potential instability or ongoing development.