Rework docs navigation and move alternatives to top-level pages (#1487)

* Rework docs navigation and move alternatives to top-level pages - Add nested docs nav with categories, collapsible groups, breadcrumbs, and a right-hand page outline with heading slugs. - Move alternatives out of /docs/alternatives into /alternatives/* marketing pages with 301 redirects. - Add github-slugger for heading IDs and require explicit width on SiteShell so new pages can't accidentally pick the narrow prose layout. - Remove the best-practices doc from public-docs. * Make docs content column prose-width
2026-06-12 12:53:30 +00:00
parent fb0c5b27f3
commit 7e46f6a647
54 changed files with 934 additions and 200 deletions
@@ -0,0 +1,99 @@
+---
+title: Happy Coder Alternative With a Desktop App and Git Worktrees
+description: Paseo ships a native desktop app, runs agents in isolated git worktrees, and supports 30+ agents. Happy Coder is mobile and web only, wraps the agent CLI, and supports Claude Code and Codex.
+nav: Happy Coder
+order: 53
+---
+
+# Paseo vs Happy Coder
+
+Happy Coder is a mobile and web client for Claude Code and Codex. It wraps the agent CLI on your laptop and syncs sessions to phone and browser over an end-to-end encrypted relay. Open source under MIT.
+
+Paseo is an app for orchestrating coding agents, with native clients on desktop, mobile, web, and the CLI. Open source (AGPL-3.0).
+
+![Paseo desktop and mobile app](/hero-mockup.png)
+
+## When to pick what
+
+Pick Happy Coder if you want the most minimal setup. Wrap an existing Claude Code or Codex session on your laptop and check in on it from your phone.
+
+Pick Paseo if you want:
+
+- A native desktop app on macOS, Linux, and Windows
+- Git worktrees for parallel agents
+- Per-worktree dev server URLs
+- GitHub PRs, checks, reviews, and merges in the app
+- Many more agents than Claude Code and Codex
+- A CLI to script agent work and drive remote daemons
+
+## Architecture
+
+Paseo runs the agent inside its own daemon. The daemon owns the agent lifecycle, the worktree, and the dev servers. Clients connect over a websocket and drive the daemon.
+
+Happy Coder runs the agent inside its existing CLI on your laptop and syncs the session to its mobile and web clients through an end-to-end encrypted relay.
+
+## Panes
+
+Paseo's app has split panes and tabs (⌘D for vertical, ⌘⇧D for horizontal). Panes include a terminal alongside your agents, a diff viewer, and a browser for testing running services.
+
+Happy Coder does not have a desktop app.
+
+## GitHub
+
+Paseo's app handles commit, push, opening PRs, watching checks and reviews, and merging.
+
+## Mobile
+
+Both tools ship native iOS and Android apps.
+
+## Providers
+
+Paseo runs Claude Code, Codex, OpenCode, and Pi natively, plus 30+ more agents through the in-app catalog including GitHub Copilot, Cursor, Gemini CLI, and Amp. Paseo speaks the [Agent Client Protocol](https://agentclientprotocol.com), so any ACP agent works. Custom providers run any CLI agent. See [Supported providers](/docs/supported-providers).
+
+Happy Coder runs Claude Code and Codex.
+
+## Worktrees and services
+
+Paseo runs each agent in its own git worktree. Each worktree gets its own dev server URL like `web.fix-auth.my-app.localhost`, so parallel agents don't fight for the same port.
+
+Happy Coder runs the agent in the directory you launched the CLI from.
+
+## CLI
+
+Paseo has a CLI that mirrors the app:
+
+```bash
+paseo run --provider codex "implement OAuth"
+paseo run --host devbox:6767 "run the test suite"
+paseo ls
+paseo send <agent-id> "add tests"
+paseo schedule create --cron "0 9 * * 1" "audit the codebase"
+```
+
+`paseo run --host` connects to a remote daemon. `paseo schedule` runs an agent on a cron. `paseo loop` retries an agent until a verification command passes.
+
+Happy Coder has a CLI to launch the wrapped session. It does not have schedules or loops.
+
+## Voice
+
+Paseo's speech-to-text and text-to-speech run locally on your device. Nothing leaves your network.
+
+## Comparison
+
+|                              | Paseo                                                           | Happy Coder            |
+| ---------------------------- | --------------------------------------------------------------- | ---------------------- |
+| License                      | Open source (AGPL-3.0)                                          | Open source (MIT)      |
+| Desktop app                  | macOS, Linux, Windows                                           | —                      |
+| Native mobile                | iOS, Android                                                    | iOS, Android           |
+| Architecture                 | Daemon owns agent lifecycle                                     | Wraps the agent CLI    |
+| Providers                    | Claude Code, Codex, OpenCode, Pi + 30+ via ACP catalog + custom | Claude Code, Codex     |
+| Split panes and tabs         | Yes                                                             | —                      |
+| In-app terminal              | Yes                                                             | —                      |
+| In-app browser               | Yes                                                             | —                      |
+| GitHub workflow in app       | Commit, push, PR, checks, reviews, merge                        | —                      |
+| Git worktrees                | Yes                                                             | —                      |
+| Per-worktree dev server URLs | Yes                                                             | —                      |
+| CLI                          | Run, `--host`, ls, send, schedule, loop                         | Launch wrapped session |
+| Local voice (on-device)      | Yes                                                             | —                      |
+
+See also: [Paseo vs Conductor](/alternatives/conductor), [Paseo vs Superset](/alternatives/superset), [Paseo vs OpenChamber](/alternatives/openchamber).