A TypeScript CLI and terminal UI for defining, launching and running persistent teams of Claude Code and Codex agents in tmux.
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
Install the Happy CLI from npm
npm install -g happy - 2
Start a Claude Code session
happy claude - 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
A CLI and workflow engine that runs coding agents like Claude Code, Codex and Copilot through configurable review, repair and test gates before work is accepted.
Message your local coding agents like Claude Code and Codex as persistent bots from iPhone, Mac, Windows, Linux or a terminal.
An Obsidian plugin for browsing, creating, and editing AI agent skills, commands, and agents across 17 coding tools like Claude Code and Cursor.
Agent Skills that make coding agents design distinctive frontends, using art direction, real photos and a browser self-check instead of generic AI landing pages.
A marketplace of 94 plugins, 202 agents, 185 skills and 105 commands for Claude Code, Codex CLI, Cursor, OpenCode, Copilot, Antigravity and Pi.