スマホから Happier を使う方法：セッションを開始して PC や CLI で続ける

Happier は、Claude Code、Codex などのエージェントを、スマホ、デスクトップ、Web からクロスデバイスで実行・オーケストレーションできるオープンソースのアプリです。セッションは信頼できるマシン（ノート PC、サーバー、開発機）で動き、スマホではワークフローを止めないための操作をします。セッションの開始、追加の指示、リクエストの承認、必要に応じた変更の確認や編集まで、リモートデスクトップを開かずに済みます。

目指すことはシンプルです。

スマホからセッションを開始し、信頼できるマシンで動かし続け、あとでデスクトップや CLI から同じセッションに戻る。

Happier が得意なのはまさにこの部分です。「進捗を確認する / 追加の指示を送る / 承認を処理する」というループをスマホで回しつつ、セッション自体はマシン（ノート PC、サーバー、開発機）上に残ります。

要点

信頼できるマシンに Happier をセットアップし、スマホを接続します。（初めての場合は、GitHub の「How it works」セクションを読んでからこのガイドに戻ってください。）
スマホでセッションを開始（または開き）、実行するマシンを選びます。
離れている間は、そのマシンで動かしておきます。
あとでセッションを所有するマシンの CLI から同じセッションを続けます。
- まだ実行中なら happier attach <session-id>
- 非アクティブで、ベンダー側の再開に対応しているなら happier resume <session-id>

「スマホから使う」とは具体的にどういうことか

重い処理をするのはスマホではありません。スマホでやるのは次のことです。

エージェントが何をしているかを読む
新しい指示を送る
ときどき出るプロンプトやアクションを承認する
ファイルや差分を見て、セッションを先に進める

実際のセッションは、リポジトリとツールがある場所（ノート PC、サーバー、開発機）で動き続けます。

大事な点がひとつあります。Happier は「モバイル専用」の製品ではありません。スマホはあくまで操作する画面のひとつです。同じセッションを、デスクトップの Web、デスクトップアプリ、またはセッションを所有するマシンの CLI からも続けられます。

よくある方法とそのトレードオフ

よくある方法：

SSH + tmux：問題ない方法ですが、スマホだと長い出力を追いかけて文脈を見失い、細かいターミナル作業が多くなりがちです。
リモートデスクトップ：普段のデスクトップツールが必要なときには使えますが、モバイルでは重くて操作しづらいです。

より合っているのは、セッションは自分のマシンで動かしたまま、スマホ向けに作られた操作画面です。

Happier：セッションを自分のマシンに置いたまま、スマホからセッションの開始、追加の指示、承認の処理ができる、スマホ向けの方法です。トレードオフ：セッションを所有するマシンがオンラインで接続されている必要があります。

tmux がすでにワークフローに合っているなら、そのまま使い続けてください。Happier は、「進捗を確認する / 指示をひとつ送る / 承認を処理する」というループをスマホでもっと楽に回す方法を加えるものです。

方法 A：配信される Web UI を使う（セルフホストの場合におすすめ）

セルフホストやカスタム Relay を使っている場合は、UI 用に アクセス可能な HTTPS URL を用意してください（たとえば Tailscale Serve による *.ts.net の URL）。

理由：ブラウザは http://localhost をセキュアコンテキストとして扱いますが、LAN や Tailscale 上の任意の HTTP オリジンはそう扱いません。Happier はセキュアコンテキストが必要なブラウザ機能に依存しています。

方法 B：ネイティブのモバイルアプリを使う

モバイルアプリを使う場合、大事なのは次の 3 点です。

正しい Relay を選ぶ（Happier Cloud またはセルフホストした Relay）
その Relay でサインインする
マシン（デーモン）が同じ Relay に接続されていることを確認する

Happier を初めて使う場合（概要と入手方法）

ポイントは、スマホでやる部分（追加の指示、承認、ちょっとした確認）を SSH に張り付かずに Happier でこなすことです。

Happier は AI コーディングエージェント向けの オープンソースのコンパニオンアプリ（モバイル / Web / デスクトップ）です。セッションは信頼できるマシン（ノート PC / サーバー / 開発機）で動き続け、Happier はスマホからワークフローを進めるための場所になります。

セットアップ：