tiann

Happy CLI — Development skill for Claude Code

Development community

Happy Coder CLI to connect your local Claude Code to mobile device.

How to install Happy CLI

This entry records only its repository, not the path inside it, so there is no exact command to give. Open tiann/happy-cli and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Happy CLI does

Happy Coder CLI to connect your local Claude Code to mobile device.

Alternatives in Development

Happy — Mobile and Web client for Claude Code, with realtime voice, encryption and fully featured 16.3k ★
Ccusage — CLI for analyzing Claude Code/Codex usage from local JSONL files 11.8k ★
Claude Coder — Kodu is an autonomous coding agent that lives in your IDE 5.2k ★

README

Happy

Code on the go controlling claude code from your mobile device.

Free. Open source. Code anywhere.

Installation

npm install -g happy-coder

Usage

happy

This will:

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

Commands

happy auth – Manage authentication
happy codex – Start Codex mode
happy connect – Store AI vendor API keys in Happy cloud
happy notify – Send a push notification to your devices
happy daemon – Manage background service
happy doctor – System diagnostics & troubleshooting

Options

-h, --help - Show help
-v, --version - Show version
-m, --model - Claude model to use (default: sonnet)
-p, --permission-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)

Requirements

Node.js >= 20.0.0
- Required by eventsource-parser@3.0.5, which is required by @modelcontextprotocol/sdk, which we used to implement permission forwarding to mobile app
Claude CLI installed & logged in (claude command available in PATH)