Keep working with your AI coding agents from a browser, organize conversations
by project, and return to a persistent assistant on your own machine.
HappyHerd is a maintained distribution of Happy,
with its complete upstream history preserved under server/.
Use it to check an agent's progress away from your terminal, keep project work together, or delegate a separate conversation while retaining the main chat. The agents run on your connected machines; the server synchronizes the clients.
First-run quickstart · Downloads · Documentation · Report an issue
Happy supplies the foundation: mobile/Web clients, Claude Code and Codex integration, and encrypted conversation synchronization. HappyHerd preserves that work and maintains its own product changes, packaging, and documentation. Upstream Happy's hosted app, store listings, desktop releases, and community belong to upstream; they are not HappyHerd downloads or support channels.
| What you can do | Ownership and evidence | Availability |
|---|---|---|
| Follow coding-agent conversations across clients | Inherited from Happy; see source lineage | HappyHerd Web client is bundled with the self-host server |
| Organize projects and use a persistent Assistant with a selected Commander | HappyHerd-owned Projects and Assistant guide | Current source; the guide includes changes newer than the public release |
| Browse work files, manage named provider accounts, and schedule agent work | HappyHerd-owned changes documented in the 1.2.4 release notes | Released capabilities and limitations are listed in those notes |
| Open and manage durable side chats | HappyHerd-owned side-chat lifecycle | Current source; do not assume the latest lifecycle is in 1.2.4 |
As checked on October 8, 2026, the latest stable installer release is HappyHerd 1.2.4, published September 20. It contains CLI, server, and Web app archives for macOS and Linux, each on arm64 and x64. Its bundled CLI reports version 1.2.3. These archives are terminal/server distributions, not native graphical apps.
The release does not distribute a HappyHerd macOS GUI, iOS or Android app, Windows installer, or npm package. Native client source and build instructions do not establish public app availability. Use the bundled Web client with your own server; no HappyHerd hosted service is promised here. See the product guide for the release/source boundary and launch work still in progress.
| Channel | Public availability | Download or entry |
|---|---|---|
| CLI and self-host server — macOS arm64/x64 | Stable installer 1.2.4, bundled CLI 1.2.3 | Release archives and the command below |
| CLI and self-host server — Linux arm64/x64 | Stable installer 1.2.4, bundled CLI 1.2.3 | Release archives and the command below |
| Web — desktop and mobile browsers | Bundled with the self-host server; feature revision follows that server's archive/deployment | Open your server's Web address; no hosted HappyHerd service promised |
| Native macOS graphical app | No public HappyHerd distribution in this release | Source build instructions, not a public download |
| Native iOS app | No public HappyHerd distribution in this release | Source build instructions, not a store/TestFlight offering |
| Android, Windows installer, npm | Not distributed by this release | No download advertised |
The proposed 1.2.5 release candidate is newer source, not a published upgrade. CI archives prove builds, not public availability or completion of the first-task journey.
Follow the first-run quickstart from server choice through account backup, terminal authorization, a first Codex result, and reopening the same conversation. Its acceptance matrix separates verified evidence from pending platform and release journeys.
On a supported macOS or Linux machine, install as your normal user:
curl -fsSL https://raw.githubusercontent.com/NickGuAI/HappyHerd/main/install.sh | shThe installer downloads a prepared release; it requires curl and tar, not a
local compiler or package manager. An interactive first run asks for a server
endpoint. The local default is http://127.0.0.1:3005; selecting it starts the
bundled server and ordinary HappyHerd daemon. Open that address in a browser on
the same computer and follow the account and terminal-connection prompts.
For a remote server, use its actual Web address instead of localhost.
If a noninteractive fresh install defers authentication, follow its printed next step:
happyherd auth login && happyherd daemon startUse the chosen provider's supported authentication/setup before starting work:
happyherd claude
# Or use Codex:
happyherd codexSee the installer guide for server selection,
upgrades, version selection, and removal. The live installer script and the
stable archive have separate revisions: installing the latest archive does not
install all features from main. Follow the complete first-run guide for the remaining
account, provider, and conversation steps.
- Product guide and launch status
- Projects, Assistant, and Commanders
- Self-host deployment and runtime boundaries
- Source components and contribution guide
- Development and verification
The repository keeps upstream source history in server/, owned branding in
branding/, deployment templates in deploy/, and maintenance scripts in
scripts/. Owned changes are recorded in the patch ledger.
Pull requests outside .dev/ run the quality gates
(Clean install, Lint, Typecheck, Unit tests, Production build) and the independent
Contract suite.
HappyHerd and upstream Happy are distributed under the MIT license. Credit for the upstream foundation belongs to the Happy contributors. For HappyHerd help or bugs, use this repository's issues. You can also buy the developer one $5 coffee.