Codeman vs Happy: self-hosted dashboard or desktop and phone apps
On this page
What Happy isWhat Codeman isSide by sideChoose Happy if...Choose Codeman if...Using bothHappy is the better fit if you want one open-source desktop app that runs Claude, GPT and Grok models on the subscriptions you already pay for, with native iOS and Android apps and voice, and no web server or network setup of your own, because its end-to-end encrypted relay handles the phone connection. Codeman is the better fit if you want the agent CLIs' own terminals, many of them side by side in one self-hosted dashboard, more CLIs, and features for unattended runs, and you are willing to set up how your phone reaches your machine.
What Happy is
Happy is an open-source harness for coding agents, with a desktop app for macOS, Windows and Linux and phone apps for iOS and Android. The desktop app runs Claude, GPT (through Codex) and Grok models in its own background runtime, Happy Agent, reusing the Claude Code, Codex and Grok CLI sign-ins on the machine. You can switch models mid-session, hand work to subagents on any of them and schedule a message hours or days ahead. Sessions live in a background service that survives quitting the app, and the phone app follows them. The desktop app also has a team mode, in which one Happy Agent on a server is shared by a team and each member signs in with their own Happy account, plus remote servers reached over a built-in tunnel, and an OS sandbox that is on by default (Seatbelt on macOS, namespaces and seccomp on Linux), with optional Docker-backed sessions.
Happy's original CLI is still available for running the vendors' own CLIs on your machine: install it with npm install -g happy and run happy claude, which keeps Claude Code's own terminal UI, or happy codex, which runs Codex's app server behind Happy's terminal view. The first run shows a QR code that pairs the machine with the phone app or the web app. In a Claude session, taking control from the phone restarts the session in remote mode, and pressing space twice or Ctrl-T on the computer takes it back. A background daemon lets you start new sessions from the phone while the computer is online. The CLI also runs Antigravity (happy agy), OpenClaw, Gemini CLI (deprecated in favour of happy agy) and any ACP-compatible agent, such as OpenCode, through happy acp. Happy's docs say the CLI is in maintenance mode and that new features ship in the desktop app.
With the original CLI, Happy sends push notifications when a Claude session needs permission, asks a question or finishes, and when a Codex or Gemini session finishes; the desktop docs do not mention push notifications. The phone app has a realtime voice agent built on ElevenLabs: 20 minutes free every 30 days, then an in-app subscription, or your own ElevenLabs agent with no limit from Happy. Session content synced between your devices is end-to-end encrypted. Voice sends session content to ElevenLabs, and the phone and desktop apps send product analytics to PostHog by default, which you can turn off in settings. The CLI uses Happy's hosted relay by default, and happy server (from the happy-server-self-host package) runs your own. The app can also create git worktrees, and a script client in its repository creates, prompts and monitors CLI sessions. Happy is MIT licensed.
What Codeman is
Codeman is a self-hosted web server that runs agent CLIs inside persistent tmux sessions and streams each real terminal to a browser, phone included. It supports ten CLIs (Claude Code, Codex, OpenCode, Gemini CLI, Antigravity, Pi, Grok Build, DeepSeek Harness, OMP, GitHub Copilot CLI) plus plain shells, flags waiting or blocked agents on their tabs and through web push, and for Claude sessions adds auto-resume after a usage limit and live subagent windows. Cron jobs, Docker containers and remote SSH sessions are built in. It needs Node.js 22+ and tmux, runs on macOS and Linux (Windows through WSL2), and is MIT licensed.
Side by side
| Happy | Codeman | |
|---|---|---|
| Clients | iOS, Android and web apps; desktop app for macOS, Windows and Linux | Any browser, installable as a PWA; codeman tui in a terminal |
| Native mobile apps | Yes | No |
| Reaching your machine from the phone | Hosted relay by default, self-hostable | You set it up: Tailscale, Cloudflare tunnel or LAN plus password (Remote Access) |
| End-to-end encryption | Yes, for session content synced between devices | No relay involved; the browser talks to your own server over the route you choose |
| What the phone shows | Happy's own session view | The CLI's own terminal (Mobile Guide) |
| Agents | Desktop: Claude, GPT and Grok models in its own runtime. CLI: Claude Code, Codex, Antigravity, OpenClaw, Gemini CLI (deprecated), ACP agents | Ten CLIs plus shell (Agent CLIs) |
| Start new sessions from the phone | Yes, through the CLI daemon or the desktop runtime | Yes |
| Push notifications | From the original CLI; not documented for desktop sessions | Yes; on iOS the web app must be on the home screen first |
| Voice | Yes, realtime voice conversation | Dictation only (Claude login, Deepgram or browser speech) |
| Resume after a usage limit | Not documented; desktop account pools can move to another account on a quota error | Yes, Claude sessions only |
| Subagents | The desktop app shows each session's subagents | Live subagent windows, Claude sessions only (Watching Agents Work) |
| Scheduled jobs | One-off scheduled messages in the desktop app; no recurring schedule documented | Yes, one-off and recurring (Cron Jobs) |
| Isolation | Desktop: OS sandbox by default, optional Docker-backed sessions. CLI: experimental sandbox | Docker cases, one container per project |
| License | MIT | MIT |
Choose Happy if...
- You want Claude, GPT and Grok models in one app, switching models mid-session and handing work to subagents on any of them.
- You want real apps: iOS and Android from the App Store or Play Store, and a desktop app for macOS, Windows or Linux.
- You do not want to run a web server or configure Tailscale, a tunnel or a password. Codeman needs that step before your phone can reach it; Happy's relay covers it, and you can still self-host the relay later.
- End-to-end encryption through a relay is the model you want.
- You want to talk to your agent by voice, not just dictate a prompt.
- You mainly use Claude Code in a terminal and like handing a session to the phone and taking it back at the desk with space twice or Ctrl-T.
Choose Codeman if...
- You want to see the agent's real terminal on the phone, with every dialog and slash command as the CLI draws it.
- You want the vendors' own CLIs doing the work. Happy's desktop app drives the models from its own runtime; Codeman runs the real
claude,codex,grokand the other CLIs in tmux. - You run many sessions across several projects and want one board that shows which of them are waiting on you (Notifications).
- You use Pi, DeepSeek Harness, OMP or GitHub Copilot CLI. Happy does not document running any of them (Happy Agent is built on Pi's libraries but does not run the Pi CLI); its original CLI can start any ACP agent through
happy acp, which we have not tried with these. - You leave Claude sessions running overnight and want them to pick up again when a usage limit resets (Keeping Agents Running).
- You want the dashboard served straight from your own machine with no sync server in between, or need one Docker container per project, agents on remote hosts you already reach over SSH, or recurring scheduled prompts.
Using both
They do not share state and run fine on the same machine. A Codeman shell session is an ordinary terminal living in tmux, so you can start Happy's original CLI (happy claude) inside one, though we have not tested how its switch between local and remote mode behaves there. Happy's desktop app runs its own background service and needs no terminal. A workable split is Happy's desktop and phone apps for multi-model work and quick check-ins, and Codeman for the long-running CLI sessions you manage from a browser.
First checked against Happy's README on 2026-09-25. Checked again on 2026-10-19 against its README, CLI README, desktop docs and source, after Happy added its desktop app (24,199 stars). Spotted something out of date? Open an issue.