Repolode
slopus

slopus/happy

A mobile, web and desktop app that runs Claude Code, Codex and Grok sessions from one place, using your existing subscriptions.

Stars
24,207
Forks
2,070
Open issues
1,074
Last commit
14 hours ago

What is it?

Happy is an open-source (MIT) harness for coding agents. It lets you run Claude, Codex and Grok in one interface, with each provider keeping its own prompts and tools, and it can delegate work to subagents across them.

You sign in with the Claude, Codex or Grok subscriptions you already have, so Happy itself adds no separate model bill. Projects stay as ordinary local folders on your own machine. The original CLI wraps Claude Code and Codex in your terminal, and sessions can be continued from a phone.

The repository holds the iOS, Android and web app, the original `happy` CLI, and the relay server that syncs sessions end to end encrypted. The desktop app and the Happy Agent runtime live in separate repositories.

Key features

  • 01Runs Claude, Codex and Grok in one app, each with its vendor's prompts and tools.
  • 02Signs in with existing Claude, Codex or Grok subscriptions.
  • 03Continues sessions on a phone, with data synced end to end encrypted.
  • 04Lets collaborators join a session and watch or steer the same agent.
  • 05Keeps projects as ordinary local folders on your own hardware.
  • 06Provides a CLI wrapper for Claude Code and Codex in the terminal.

Use cases

  • Switching between Claude, Codex and Grok for different coding tasks without paying for extra model access.
  • Checking on or steering a running coding agent from your phone while away from your desk.
  • Pair programming or reviewing an agent's work with a colleague in a shared session.
  • Running a self-hosted, auditable agent setup from source.

Quick start

  1. 1

    Install the Happy CLI from npm

    npm install -g happy
  2. 2

    Start a Claude Code session

    happy claude
  3. 3

    Or start a Codex session instead

    happy codex

Things to know

  • Using it requires existing paid Claude, Codex, or Grok subscriptions.
  • Multi-model sessions and teams are in the separate desktop app, not the original CLI in this repository.

Topics

FAQ

What is happy?
A mobile, web and desktop app that runs Claude Code, Codex and Grok sessions from one place, using your existing subscriptions. Happy is an open-source (MIT) harness for coding agents. It lets you run Claude, Codex and Grok in one interface, with each provider keeping its own prompts and tools, and it can delegate work to subagents across them.
Is happy free to use? What license does it have?
happy is open source under the MIT license. Check the license terms before using it in commercial products.
Is happy still maintained?
Actively maintained. The last commit to happy was on Oct 19, 2026.
What can I use happy for?
Switching between Claude, Codex and Grok for different coding tasks without paying for extra model access. Checking on or steering a running coding agent from your phone while away from your desk. Pair programming or reviewing an agent's work with a colleague in a shared session. Running a self-hosted, auditable agent setup from source.
How do I install happy?
Install the Happy CLI from npm: npm install -g happy Start a Claude Code session: happy claude Or start a Codex session instead: happy codex
Where can I get happy?
The source code and installation instructions are on GitHub: https://github.com/slopus/happy

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects