Happier AI Agent

<div align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset=".github/logotype-white.svg" /> <img src=".github/logotype-black.svg" alt="Happier" width="340" /> </picture>

The multi-device control room to orchestrate teams of 100+ coding agents

From your phone, desktop and browser.

Claude Code, Codex, OpenCode, Pi and more, working together and in parallel on your own machines.

Sessions can spawn subagents across agents: e.g. Claude asking Codex for a review, or Codex delegating work to Claude subagents. Switch agents mid-session. Approve, steer, review and commit from wherever you are.

Open source · Self-hostable · End-to-end encrypted

<p><a href="README.md">English</a> | <a href="README.ja.md">日本語</a> | <a href="README.zh-CN.md">简体中文</a> | <a href="README.ko.md">한국어</a> | <a href="README.es.md">Español</a></p> <p> <a href="#get-started">Get started</a> · <a href="#downloads">Downloads</a> · <a href="https://docs.happier.dev">Docs</a> · <a href="#self-hosting">Self-host</a> · <a href="https://discord.gg/W6Pb8KuHfg">Discord</a> </p> <p> <a href="LICENCE"><img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-blue" /></a> <a href="https://happier.dev/download"><img alt="Downloads" src="https://img.shields.io/endpoint?url=https%3A%2F%2Fstats.happier.dev%2Fdownloads-badge.json" /></a> <a href="https://discord.gg/W6Pb8KuHfg"><img alt="Discord" src="https://img.shields.io/endpoint?url=https%3A%2F%2Fstats.happier.dev%2Fdiscord-badge.json" /></a> <a href="https://docs.happier.dev/releases"><img alt="Latest stable release" src="https://img.shields.io/npm/v/%40happier-dev%2Fcli?label=stable&color=2ea043" /></a> </p>

<a href="https://github.com/happier-dev/happier/discussions/226"><strong>Latest Happier project update</strong></a>

<p>Happier is free and open source.<br /> You use your existing subscriptions and coding agents.</p> <p> <img src=".github/desktop-2000.png" alt="Happier desktop app: sessions, diffs and terminal in one window" width="100%" /> </p> <p> <img src=".github/mobile-2000.png" alt="Happier mobile app: the same session from your phone" width="88%" /> </p> <p><b>Built-in supported agents (& 30+ more)</b></p> <!-- .github/supported-agents-light.png and .github/supported-agents-dark.png are generated by scripts/generateSupportedAgentsStrip.mjs; regenerate them, do not hand-edit --> <p align="center"> <a href="https://happier.dev/agents"> <picture> <source media="(prefers-color-scheme: dark)" srcset=".github/supported-agents-dark.png" /> <img width="550" src=".github/supported-agents-light.png" alt="Agents supported by Happier: Claude Code, Codex, OpenCode, Gemini CLI, Auggie, Qwen Code, Kimi, Kilo, Kiro, Devin, Pi, GitHub Copilot, Cursor, Grok, FX, Droid and Antigravity" /> </picture> </a> </p> <p>Any agent that speaks ACP can be added from the settings.</p> </div>

Get started

1. Install on your computer

The desktop app is the recommended way in: it sets up the CLI and the daemon for you.

<a href="https://happier.dev/download"> <picture> <source media="(prefers-color-scheme: dark)" srcset=".github/download-desktop-white.svg" /> <img width="186" height="45" alt="Download Happier for desktop: macOS, Windows, Linux" src=".github/download-desktop-white.svg" /> </picture> </a> <br /><br /> <details> <summary><b>Prefer the terminal?</b> Install the CLI and daemon without the desktop app</summary>

macOS/Linux:

curl -fsSL https://happier.dev/install | bash

Windows:

iwr https://happier.dev/install.ps1 -useb | iex

If you specifically want the npm package instead: npm install -g @happier-dev/cli (CLI docs).

</details> <details> <summary><b>Already use Claude Code, Codex or another coding agent?</b> Let it set Happier up with you</summary>

Paste this into your agent:

Set up Happier on this computer by following https://docs.happier.dev/getting-started/agent-setup.mdx
Fetch that file raw (for example with curl) and follow it step by step with me.

It asks what it needs to know, confirms each change, and leaves the sign-in approval and your agent's own login to you. Set up with your coding agent

</details> <details> <summary><b>Use Grok Bot?</b> Install and manage Happier through Grok on X</summary>

Install the Happier session control Grok Bot on X. On first run it installs the Happier CLI on its own computer, pairs with your Happier Cloud account or self-hosted relay, and starts the daemon. You control how hands-on it is: watch only, assist, or drive sessions. Grok Bot integration

</details> <details> <summary><b>Installing on a remote computer or devbox?</b> Set it up over SSH, from your machine</summary>

One command installs the CLI and the daemon on the remote host (release-signature verified) and registers it as one of your machines:

happier machine setup --ssh user@host

To sign the remote machine in without a browser on its side, run this from a machine where you are already signed in:

happier auth pair-remote --ssh user@host

Headless alternative on the remote host itself: happier auth login --no-open --method web prints an authorization URL you approve from any browser. Machines and the daemon

</details>

You sign in from the app, or on first run.

2. Add your phone

<table> <tr> <td align="center"> <a href="https://happier.dev/appstore"><img width="135" height="39" alt="Download on the App Store" src="https://github.com/user-attachments/assets/45e31a11-cf6b-40a2-a083-6dc8d1f01291" /></a> </td> <td align="center"> <a href="https://happier.dev/playstore"><img width="135" height="39" alt="Get it on Google Play" src="https://github.com/user-attachments/assets/acbba639-858f-4c74-85c7-92a4096efbf5" /></a> </td> <td align="center"> <a href="https://happier.dev/apk"><b>Direct&nbsp;APK</b></a><br />_{stable release} </td> </tr> <tr> <td align="center"> <a href="https://happier.dev/appstore"><picture><source media="(prefers-color-scheme: dark)" srcset=".github/qr-app-store-white.svg" /><img width="110" height="110" alt="App Store QR code" src=".github/qr-app-store-black.svg" /></picture></a> </td> <td align="center"> <a href="https://happier.dev/playstore"><picture><source media="(prefers-color-scheme: dark)" srcset=".github/qr-play-store-white.svg" /><img width="110" height="110" alt="Google Play QR code" src=".github/qr-play-store-black.svg" /></picture></a> </td> <td align="center"> <a href="https://happier.dev/apk"><picture><source media="(prefers-color-scheme: dark)" srcset=".github/qr-apk-white.svg" /><img width="110" height="110" alt="Direct APK QR code" src=".github/qr-apk-black.svg" /></picture></a> </td> </tr> </table>

Sign in with the same account and your sessions, machines and settings are already there.

3. Start a session

In the app → Press New session, pick the machine, the folder and the agent. No terminal needed.

Or in the terminal, from any project folder:

happier            # Claude Code
happier codex      # Codex
happier opencode   # OpenCode

Either way, the session shows up everywhere at once: keep typing in the terminal, follow along and approve from your phone, review in the browser. happier --help lists the other agents and commands.

What you can do

<h3 align="center">📱 Run your agents from your phone, desktop or the web</h3> <p align="center">Start, steer, review and approve sessions from whichever device is in your hand. Sessions are cross-device, so you pick up the same session wherever you are, including Claude Code, Codex or OpenCode sessions already running on your machine. <a href="https://docs.happier.dev/sessions/continuing-a-session">Continuing a session</a></p> <p align="center"><img src=".github/screenshots/session.png" width="640" alt="A Happier session showing the agent thinking, tool calls and the final reply" /></p> <br/> <h3 align="center">🖥️ Orchestrate parallel sessions across machines</h3> <p align="center">Run as many sessions as you like and pick the machine, folder, agent and model for each one. Follow all of them from one list, whichever machine they run on. <a href="https://docs.happier.dev/sessions/new-session-shortcuts">Starting a session</a> · <a href="https://docs.happier.dev/apps/daemon">Machines and the daemon</a></p> <p align="center"><img src=".github/screenshots/session-list.png" width="360" alt="Session list with several sessions running in parallel" /></p> <br/> <h3 align="center">🔄 Switch agents mid-session</h3> <p align="center">Move a session from Claude to Codex, or back, in place. The session keeps its id, history and settings, and the arriving agent gets a summary of the recent conversation. <a href="https://docs.happier.dev/sessions/continue-with-another-agent">Continue with another agent</a></p> <p align="center"><img src=".github/screenshots/agent-switch.png" width="380" alt="Agent and model picker with OpenCode, Claude, Codex and other agents" /></p> <br/> <h3 align="center">🔔 An inbox for what needs you</h3> <p align="center">Permission requests, agent questions and unread sessions gather in one attention center across all sessions and machines. A push notification opens the exact session that asked. <a href="https://docs.happier.dev/sessions/inbox-and-approvals">Inbox and approvals</a></p> <p align="center"><img src=".github/screenshots/inbox-popover.png" width="300" alt="Needs attention inbox with sessions waiting on you" /></p> <br/> <h3 align="center">📝 Review diffs and send notes back</h3> <p align="center">Browse your agent's changes and mark the exact lines you want addressed. Send the notes straight back to the same session or to a new one. <a href="https://docs.happier.dev/code/review-comments">Review comments</a></p> <p align="center"><img src=".github/screenshots/diff-short.png" width="640" alt="Diff review of an agent change" /></p> <br/> <h3 align="center">🌿 Git and worktrees from any device</h3> <p align="center">Stage, commit, push, branch and open pull requests without leaving the app. Start a session in its own Git worktree from any local or remote branch, or in the folder you are already in. <a href="https://docs.happier.dev/code/git">Git</a> · <a href="https://docs.happier.dev/sessions/new-session-shortcuts">New session options</a></p> <p align="center"><img src=".github/screenshots/git.png" width="600" alt="Review diff with stage buttons next to the Git panel with changed files and a commit message field"></p> <br/> <h3 align="center">📬 Queue it, steer it</h3> <p align="center">Queue messages while the agent works and reorder or edit them before they run. Steer a running turn without interrupting it. <a href="https://docs.happier.dev/sessions/steering">Steering</a> · <a href="https://docs.happier.dev/sessions/pending-queue">Pending queue</a></p> <p align="center"><img src=".github/screenshots/queue.png" width="640" alt="Pending queue with messages waiting while the agent works" /></p> <br/> <h3 align="center">🪪 Subscriptions, account pools and usage limits</h3> <p align="center">Connect several accounts you own for the same service and group them in a pool. With automatic switching turned on, a pool moves sessions to another account when one hits a usage limit or its sign-in expires, so the work keeps going. When there is nowhere to switch, Claude sessions resume on their own once the limit resets. <a href="https://docs.happier.dev/accounts/connected-services">Connected services and pools</a> · <a href="https://happier.dev/features/usage-limits">Usage limits</a></p> <p align="center"><img src=".github/screenshots/account-pools.png" width="390" alt="Account pools list with an automatic and a manual pool and a Create pool button" /></p> <br/> <h3 align="center">📊 Track your accounts usage</h3> <p align="center">See how much is left on each of your connected accounts and subscriptions. For a Claude subscription that means the 5-hour and weekly limits, with the time until each one resets. <a href="https://docs.happier.dev/accounts/connected-services">Connected services</a></p> <p align="center"><img src=".github/screenshots/account-usage.png" width="420" alt="Claude subscription usage card with 5-hour and weekly limits and reset times" /></p> <br/> <h3 align="center">🤝 Subagents across agents</h3> <p align="center">A session can hand work to another agent. Claude can start a review, plan or delegate run on Codex, for example, and you follow every run from the Agents tab in the session. <a href="https://docs.happier.dev/extending/subagents">Delegated work</a></p> <p align="center"><img src=".github/screenshots/subagents.png" width="480" alt="Agents panel listing working and finished subagents" /></p> <br/> <h3 align="center">🗂️ Files, editor and terminal</h3> <p align="center">Browse, search and edit the files in a session's folder from any device. Open a terminal on the connected machine when you need a quick command. <a href="https://docs.happier.dev/code/files-and-editor">Files and editor</a> · <a href="https://docs.happier.dev/extras/embedded-terminal">Embedded terminal</a></p> <p align="center"><img src=".github/screenshots/files-terminal.png" width="560" alt="File editor open on a project file next to the project file list" /></p> <br/> <h3 align="center">⌨️ Love the terminal? Keep using it!</h3> <p align="center">Run Claude Code, Codex or OpenCode in their own terminal UIs. Happier mirrors those sessions to every device, so you can follow along, send messages and approve from anywhere. <a href="https://docs.happier.dev/sessions/claude-unified-terminal">Claude unified terminal</a></p> <br/> <h3 align="center">🎙️ Voice</h3> <p align="center">The voice assistant follows your running sessions, answers permission requests for you and sends the messages you dictate. Use realtime ElevenLabs voice, or build a local pipeline from on-device speech, OpenAI-compatible endpoints, Google Gemini and Google Cloud, or Kokoro. <a href="https://docs.happier.dev/voice">Voice</a></p> <p align="center"> <picture><source media="(prefers-color-scheme: dark)" srcset=".github/screenshots/voice/elevenlabs-dark.svg"><img src=".github/screenshots/voice/elevenlabs-light.svg" height="32" alt="ElevenLabs"></picture>&nbsp;&nbsp;&nbsp; <picture><source media="(prefers-color-scheme: dark)" srcset=".github/screenshots/voice/openai-dark.svg"><img src=".github/screenshots/voice/openai-light.svg" height="32" alt="OpenAI"></picture>&nbsp;&nbsp;&nbsp; <picture><source media="(prefers-color-scheme: dark)" srcset=".github/screenshots/voice/googlegemini-dark.svg"><img src=".github/screenshots/voice/googlegemini-light.svg" height="32" alt="Google Gemini"></picture>&nbsp;&nbsp;&nbsp; <picture><source media="(prefers-color-scheme: dark)" srcset=".github/screenshots/voice/googlecloud-dark.svg"><img src=".github/screenshots/voice/googlecloud-light.svg" height="32" alt="Google Cloud"></picture> </p> <br/>

Also in the box

• Session handoff. Move a live Claude Code or OpenCode session to another machine and bring the working tree along if you want it. Session handoff
• Session sharing. Invite someone with view or edit access, or publish a read-only public link. Session sharing
• Happier as an MCP server. happier mcp serve lets any MCP host create sessions, send messages and run session actions. Happier as an MCP server · CLI
• Grok Bot integration. Install and manage Happier sessions through Grok on X — setup, monitoring, and session control in one shareable bot. Grok Bot integration
• MCP servers, configured once. Use them with every agent on every machine. MCP servers
• Add a machine over SSH from the app or the CLI. Machines and the daemon
• Self-hosting. The self-hosted relay runs the same apps, encryption and features. Self-hosting
• End-to-end encryption. Content is encrypted on your devices by default. Security

Step-by-step guides live at guides.happier.dev.

How Happier works

      Phone           Desktop          Browser
        │                │                │
        └────────────────┼────────────────┘
                         │
                         ▼
          Happier relay (hosted or yours)
        syncs end-to-end encrypted sessions
          between your devices and machines
                         │
                         ▼
      Your machines (laptop, desktop, VPS, dev box)
        the Happier daemon starts and manages
          agent processes where your code lives
                         │
                         ▼
      Claude Code · Codex · OpenCode · Pi · ...
        each agent talks to its own model
                provider directly

The relay stores and forwards content it cannot read: session content is encrypted on your devices before it reaches the server. The server only processes what routing needs, such as session ids, timestamps, turn status and usage metadata. Your agents keep talking to their model providers directly.

Self-hosting

Run your own relay with one command:

happier relay host install --mode system

This installs and updates a managed relay service on the current machine. For a remote host: happier relay host install --ssh user@host --mode system.

The self-hosting docs (also reachable at happier.dev/self-host) cover the details, with Docker and Proxmox as alternatives.

Security

• Content is end-to-end encrypted by default. Code, prompts, messages and transcripts are encrypted on your devices before they ever reach a server. Encryption
• The server processes routing metadata. Session ids, timestamps, turn status and usage metadata are visible to the relay so it can sync your devices.
• Self-host operators choose their storage policy. A self-hosted server can be configured with other storage policies for its deployment. Server encryption settings
• Model traffic stays with your agents. Each agent talks to its own model provider directly.

More in the security docs.

Downloads

Platform	Get it
iOS	App Store
Android	Google Play · APK
macOS · Windows · Linux (desktop app)	happier.dev/download · all desktop builds
Web	cloud.happier.dev
CLI (macOS, Linux)	curl -fsSL https://happier.dev/install | bash
CLI (Windows)	iwr https://happier.dev/install.ps1 -useb | iex

Release notes live in the changelog.

Release channels and nightly builds

Everything above installs the stable channel. Two faster channels ship ahead of it, and they install side by side (happier, hprev, hdev), so trying one never breaks your stable setup:

• preview: new features land here first, ahead of stable.
• dev: nightly builds of the latest changes. Can contain partial commits and can break at any moment.

<details> <summary><b>Install preview or dev builds</b></summary>

Preview (macOS/Linux, then Windows):

curl -fsSL https://happier.dev/install-preview | bash

iwr https://happier.dev/install-preview.ps1 -useb | iex

Dev:

curl -fsSL https://happier.dev/install-dev | bash

iwr https://happier.dev/install-dev.ps1 -useb | iex

Then run hprev or hdev instead of happier. If you want happier to map to your dev lane, add alias happier='hdev' to your .bashrc/.zshrc.

On dev you must run everything from the dev releases (CLI, app, daemon and server): the hosted cloud (cloud.happier.dev) runs stable, so preview and dev features may not work against it, and dev has no hosted web app (self-host the dev server to use the dev web UI).

Mobile and server dev builds:

• iOS TestFlight
• Android dev APK
• Server images: Docker Hub happierdev/relay-server:dev · GHCR
• Dev box (CLI + daemon + agents preinstalled): Docker Hub happierdev/dev-box:dev

</details>

How channels map to release tags and how each install method updates: docs.happier.dev/releases/updates.

Community and contributing

Happier is built in the open, and it grows through real feedback. If something feels broken, missing or awkward, we want to hear about it.

• Bugs, with repro steps: GitHub issues
• Ideas and design questions: GitHub discussions
• News, questions and quick feedback: Discord
• Code, docs and development setup: CONTRIBUTING.md

A clear issue is often worth more than a pull request: say what you did, what you expected, and what happened instead.

Why “Happier”?

We originally started as contributors to Happy, submitting fixes, improvements, and new features upstream.

We were using it daily for work and genuinely loved the concept. Over time, we realized that our own needs required faster iteration that we could not comfortably explore within the main project.

So we started building them for ourselves.

After weeks of refining, fixing, and extending the foundation, we decided to share Happier so others could try it, use it, and help shape what comes next.

Happier is about exploring a faster-moving, more collaborative direction, while remaining deeply grateful for the foundation Happy provided. We loved and still love Happy. ❤️ Happier would not exist without it.

<div align="center"> <hr /> Built in Switzerland. MIT licensed.

Not affiliated with or endorsed by Anthropic, OpenAI, or Google.

</div>