スマホから差分（diff）をレビューする方法：AI が書いたコードをコミット前に確認
コミットしていない変更（と AI による編集）を、これからコミットする内容を本当に信頼できるだけの文脈つきでレビューする、スマホ中心のワークフロー。
- CLI
- 0.2.17
- プレビュー ref
- a2c45c8
AI コーディングツールは便利ですが、きちんとレビューしていない変更をコミットするのは落ち着きません。
デスクなら簡単です。スマホだと扱いにくくなります。
- SSH なら実際の状態は見られますが、小さな画面で差分をレビューして正確にステージするのは疲れます。
- GitHub モバイルは PR のレビューには便利ですが、自分の マシンにコミットされずに残っている変更にはあまり役立ちません。
- リモートデスクトップは動きますが、誤タップでまずいコミットをしてしまいやすい方法です。
役立つのは、次のようなものです。
「本物のレビューのように差分をスクロールし、ファイルを開いて確認し、小さな修正をひとつして、次に進む。」
このワークフローなら、スマホでの SSH、リモートデスクトップ、GitHub モバイルにありがちなトレードオフを避けられます。
要点
- Happier をセットアップし（またはダイレクトセッションで接続し）、スマホでセッションを開きます。
- バージョン管理（Source control）→ レビュー（Review）に進みます。
- コミットしていない差分全体をスクロールし、確認が終わったものは折りたたみます。
- おかしな点があれば、そのファイルをエディタのタブで開いて直し、レビューに戻ります。
- 差分を信頼できたらステージやコミットができます。あるいは「レビューのみ」で止めて、あとでノート PC からコミットしても構いません。
課題
エージェントが多くのファイル（あるいは少数の重要なファイル）を変更したら、コミット前に 2 つの問いに答える必要があります。
- 何が変わったか？（どのファイルかだけでなく、実際の差分の中身）
- 信頼できるか？（正しい変更か、範囲は適切か、想定外のものが紛れ込んでいないか）
スマホでよくある失敗は、ツールが扱いにくいせいで丁寧にレビューしなくなることです。
よくある方法とそのトレードオフ
- SSH + git diff は動きますが、スマホでは流し読みになりやすく、「待って、なぜこのファイルが変わった？」という瞬間を見逃しがちです。
- リモートデスクトップ は動きますが、モバイルでは誤タップでまずい編集をしてしまいやすい方法です。
- GitHub モバイル は PR のレビューには便利ですが、マシン上のコミットされていない作業ツリーは表示されません。
役立つのは、スマホで使えるレビュー画面です。PR のように差分をスクロールし、ファイルに飛び、修正をひとつして、続ける。
- Happier：コーディングエージェントをクロスデバイスで実行・オーケストレーションできるオープンソースのアプリです。リポジトリは自分のマシンに置いたまま、スマホで「PR のように差分全体をスクロールする」表示が使えます。 トレードオフ：マシンやデーモンに到達できなければ、SSH やリモートデスクトップに戻ることになります。
考え方：変更ファイルの一覧と「レビュー」
変更ファイルの一覧が答えるのは「どのファイルが変わったか？」です。
レビュー画面が答えるのは「どんな作業が行われたか？」です。
Happier の レビュー 画面は、「実際の作業をスクロールして確認する」ための画面です。
- 差分は順次表示される
- 確認が終わったファイルは折りたためる
- 位置を見失わずにエディタに移動できる
これが、小さなターミナルでレビューするよりモバイルでのレビューを扱いやすくしている点です。
Happier を初めて使う場合（概要と入手方法）
Happier は、Claude Code、Codex、OpenCode などの AI コーディングエージェント向けの オープンソースのコンパニオンアプリ（モバイル / Web / デスクトップ）です。
ここでのワークフローは、リポジトリと Git はワークスペースを所有するマシンに置いたまま、Happier を使ってスマホから直接差分をレビューするというものです。
このガイドでいえば、リモートデスクトップに頼らずに、コミットされていない実際の作業ツリーの差分 をモバイルでレビューできる（小さな修正もできる）ということです。
セットアップ：
- スマホから Happier を使う方法
- GitHub: https://github.com/happier-dev/happier
- インストール / ダウンロード: https://github.com/happier-dev/happier#how-it-works
- Discord（コミュニティとサポート）: https://discord.gg/W6Pb8KuHfg
手順：スマホからコミットされていない差分をレビューする
1) バージョン管理を開く
セッションの画面で バージョン管理（Source control）を開きます。
ブランチの概要と変更ファイルの一覧が表示されます。
2) レビューを開く
レビュー（Review）を開きます。
PR をレビューするように差分全体をスクロールします。
- 確認が終わったファイルは折りたたむ
- 怪しいものを見つけたら止まる
3) 小さな問題を確認して直す（位置を見失わずに）
小さな問題（命名、消し忘れのデバッグログ、設定の誤った編集）を見つけたら：
- そのファイルをエディタで開く
- 修正する
- レビューに戻って続ける
大事なのは、レビューが途切れないことです。何度も文脈を切り替えずに済みます。
4) 次に何をするか決める
しっかりレビューしたあとの妥当な結論はいくつかあります。
- レビューのみ：変更は信頼できるので、あとでノート PC からステージ / コミットする。
- いまステージ / コミットする（Git の操作が有効で、モバイルから行っても問題ない場合）。
- エージェントに追加の指示を送る（「この 2 ファイルを直して、これは元に戻して、コミットを分けて」）。
添付ファイルとプロジェクトのファイル（混同しないこと）
変更をレビューするときは、添付ファイルだけでなく ワークスペースのファイル（リポジトリ）を見ていることを確認してください。
添付ファイルはログや単発の成果物をモデルに渡すのに便利ですが、コミットするつもりのリポジトリのファイルとは別物です。
よくある間違い
- ファイル一覧だけをレビューする（差分を見ない）→ 実際に危険な変更を見逃す。
- モバイルのターミナルでレビューして、急いでしまう → デスクトップなら承認しなかったものを承認してしまう。
- GitHub モバイルが自分のマシンを反映していると思い込む → 変更がすでに PR に push されていない限り、反映されていません。
トラブルシューティング
症状：バージョン管理や差分が表示されない
考えられる原因：
- 所有するマシンやデーモンに到達できない
- 別のサーバーやプロファイルを使っている
対処：
- 正しいサーバーに接続しているか確認する。
- マシンがオンラインで到達できるか確認する。
症状：ファイルが変わったはずなのにレビューが空
考えられる原因：
- 別のリポジトリやワークスペースを見ている
- SCM のバックエンドがまだ更新されていない
対処：
- 変更ファイルの一覧に戻り、正しいリポジトリの文脈にいるか確認する
よくある質問
コミットせずにスマホから差分をレビューできますか？
はい。それがデフォルトとして適していることもよくあります。
スマホでレビューし、実際のコミットや push はあとで、ツールが揃ったノート PC から行いましょう。
AI が生成したコードのレビューにこれで十分ですか？
最初のチェックとしては十分です。特に、明らかな範囲の問題を見つけるのに向いています。
リスクの高い変更は、マージ前にノート PC でより深くレビューする（または別のエージェントにレビューを頼む）ようにしましょう。