gem-hunter
Language: TypeScript
Happy Coder CLI to connect your local Claude Code to mobile device
Warning
This repository has been merged to the main one. All issues and code is now living there.
Code on the go — control AI coding agents from your mobile device.
Free. Open source. Code anywhere.
npm install -g happy-coder
happy
This will:
happy gemini
Start a Gemini CLI session with remote control capabilities.
First time setup:
# Authenticate with Google
happy connect geminihappy – Start Claude Code session (default)happy gemini – Start Gemini CLI sessionhappy codex – Start Codex modehappy auth – Manage authenticationhappy connect – Store AI vendor API keys in Happy cloudhappy notify – Send a push notification to your deviceshappy daemon – Manage background servicehappy doctor – System diagnostics & troubleshootinghappy connect gemini # Authenticate with Google for Gemini happy connect claude # Authenticate with Anthropic happy connect codex # Authenticate with OpenAI happy connect status # Show connection status for all vendors
happy gemini # Start Gemini session happy gemini model set <model> # Set default model happy gemini model get # Show current model happy gemini project set <id> # Set Google Cloud Project ID (for Workspace accounts) happy gemini project get # Show current Google Cloud Project ID
Available models: gemini-2.5-pro, gemini-2.5-flash, gemini-2.5-flash-lite
-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-h, --help - Show help-v, --version - Show versionHAPPY_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)GEMINI_MODEL - Override default Gemini modelGOOGLE_CLOUD_PROJECT - Google Cloud Project ID (required for Workspace accounts)Personal Gmail accounts work out of the box:
happy connect gemini happy gemini
Google Workspace (organization) accounts require a Google Cloud Project:
happy gemini project set your-project-idOr use environment variable:
GOOGLE_CLOUD_PROJECT=your-project-id happy gemini
Guide: https://goo.gle/gemini-cli-auth-docs#workspace-gca
Interested in contributing? See CONTRIBUTING.md for development setup and guidelines.
claude command available in PATH)npm install -g @google/gemini-cli)happy connect geminiMIT