How to use multiple Happier servers from your phone (work / personal)

Keep work/personal (or cloud/self-host) sessions separate, and avoid the “wrong server” confusion when opening links and notifications on mobile.

Based on
CLI
0.1.0
Preview ref
f36aa45

I started using multiple Happier servers pretty early (cloud + a self-host, and later a work server), and I hit the same confusion everyone hits:

A link opens, a notification pops, and you’re suddenly thinking:

  • “Wait — which server am I on right now?”
  • “Why are my sessions gone?”
  • “Why did that connect flow send me to Server settings?”

This is the workflow that made multi-server feel predictable from my phone.

TL;DR

  • Treat each server as a separate “profile”: auth and sessions are server-scoped.
  • When something looks missing, you’re usually just on the wrong server.
  • Notifications/links are designed to not silently trust new servers; that’s why you sometimes land in Server settings.

What I mean by “multiple servers from your phone”

I mean you have more than one API/webapp target saved on your phone, for example:

  • Happier Cloud
  • your personal self-host
  • a work/company self-host

…and you want to switch between them without losing your mind.

What I tried first (and where I bounced off)

  • One server only: simplest, but not realistic if you want work/personal separation.

  • Bookmark different URLs: works, but I’d constantly end up in the wrong place after notifications.

  • Happier: has explicit server profiles and link handling that tries to keep you safe (it won’t silently add/trust a new server). Trade-off: you have to accept that “server switching” is a real part of the mental model.

If you’re new to Happier (what it is, and where to get it)

If you haven’t seen Happier before: it’s an open-source companion app (mobile/web/desktop) for AI coding agents like Claude Code, Codex, and OpenCode.

The session still runs on a machine you trust (laptop/server/dev box). Happier is where you monitor, steer, approve, review, and keep going from your phone.

Get set up:

The model that makes multi-server predictable

Three rules explain most “wtf just happened” moments:

  1. A server profile is a saved API/webapp target.
  2. Auth is scoped per server (logging into server A doesn’t log you into server B).
  3. Your sessions are scoped per server (so switching servers can make your session list look empty).

Once you internalize those, most confusion turns into: “I’m on the wrong profile.”

Step-by-step: add and switch servers on your phone

  1. Open Server settings.
  2. Add/select/rename your server profiles.
  3. Sign in on the server you actually want to use.

On web, note that server selection can be per-tab or a device default.

Happier handles incoming links based on whether the server is already saved on the device.

Case 1: the target server is already saved

  • Happier can switch to that server profile and continue.

Case 2: the target server is not saved (but you already have saved servers)

  • Happier opens Server settings with the incoming URL prefilled.
  • You explicitly choose Add & Use.

This is intentional: it prevents the app from silently trusting a new server in the background.

Troubleshooting

Symptom: I switched servers and my sessions disappeared

Likely cause:

  • those sessions belong to another server profile

Fix:

  • switch back to the original server

Symptom: A notification sent me to Server settings

Likely cause:

  • that notification came from a server URL that isn’t saved on this device yet

Fix:

  • add the server from the prefilled form, then continue to the intended session
mobilemulti-serverworkflows
Last updated: 2026-04-03