Practical overview
When it fits
Use the original CLI when you want to launch Claude Code or Codex in a terminal and continue the session remotely. Use the separate desktop app and Happy Harness when the task calls for multi-provider orchestration, subagents or collaborative sessions.
Who it is for
- Developers who want to start Claude Code or Codex sessions in a terminal and continue them from a phone.
- Users coordinating tasks across the model providers described by Happy’s Harness.
- Teams or collaborators who want to watch and steer a shared agent session.
Documented uses
- Start a Claude Code or Codex session through the Happy CLI.
- Continue a CLI coding-agent session from a phone.
- Route tasks across supported model providers and delegate work to subagents through Happy Harness.
- Invite a collaborator to observe and steer a shared session.
Requirements & limits
The repository describes Happy as free and open source under the MIT license. It says users sign in with their Claude, Codex or Grok subscriptions; Happy adds a harness rather than another subscription bill.
- The original CLI directly wraps Claude Code and Codex; the README directs multi-model and team workflows to the separate desktop app and Happy Harness.
- The repository says mobile session data is end-to-end encrypted and sessions can be shared with collaborators who can steer them.
- Happy’s CLI is installed through npm, and the documented commands are
happy claudeandhappy codex. - The repository identifies the implementation language as TypeScript and the license as MIT.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Start a Claude Code or Codex session with Happy CLI
Install the original Happy CLI and launch one of its documented coding-agent harnesses.
Before you start
- npm
- Access to the Claude Code or Codex harness you intend to use
Steps
Install the CLI globally with the command below.
npm install -g happyRun
happy claudeto start Claude Code, orhappy codexto start Codex.
Expected outcome
A Claude Code or Codex session started through Happy’s original CLI; the README says the CLI can continue sessions from a phone.
Guide limitations
- This guide covers only the original CLI workflow; multi-model sessions and teams are directed to the separate desktop app and Happy Harness.
- Provider access and setup beyond the CLI commands are not detailed here.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 13 October 2026
- Original website title
- slopus/happy · Official homepage title · retained in its source language

