スマホから Augment（Auggie）セッションを監視する方法
信頼できるコンピューターで Auggie を起動し、SSH なしでスマホから進捗の確認、承認、フォローアップを行う実践的なワークフローです。
- CLI
- 0.2.17
- プレビュー ref
- a2c45c8
Augment には「とにかくコーディングを始める」感覚があります。
難点は、Auggie セッションが動いている間ずっとノートPCのお守りをすることです。
タスクに20〜60分かかるなら、次のことができるワークフローが欲しくなります。
- リポジトリのあるコンピューターでセッションを開始する
- コンピューターから離れる
- スマホから進捗を確認する
- プロンプトや承認に答える
- フォローアップを1つ送る
このガイドはそのワークフローです。
要点
- Auggie をインストールし、セッションを実行するコンピューターで
auggie --versionを確認します。 - スマホのワークフロー（Happier はその選択肢の1つ）で、セッションの監視、承認、フォローアップを行います。
- Augment の認証ステータスが 不明（Unknown） でも慌てないでください。Auggie の認証確認は控えめです。
- Auggie が見つからない場合は、
HAPPIER_AUGGIE_PATHにauggieバイナリのフルパスを設定します。
課題
「スマホから監視する」がうまくいかない理由は、たいてい次の3つのどれかです。
- セッションがスリープするコンピューターで動いている（セッションが止まる）
- SSH しかない（スマホがターミナルになる）
- 認証やステータスがあいまい（見ているものを信用できない）
Auggie はローカル CLI ベースのプロバイダーです。コードがリポジトリのある場所から出ないのは利点です。
ただし、スマホでのワークフローは意図して組み立てる必要があります。
よくある方法とトレードオフ
-
スマホからの SSH: 使えますが、小さなターミナルで長い出力を読むのは大変です。
-
リモートデスクトップ: 重くて扱いにくいです。
-
キーボードの前に戻るまで待つ: 安全ですが遅いです。
-
Happier: コーディングエージェントをクロスデバイスで実行・オーケストレーションするためのオープンソースアプリです。スマホから Augment セッションを開き、進捗を確認し、承認に対応し、短いフォローアップ1つで実行を後押しできます。 トレードオフ: Auggie を実行するコンピューターがオンラインである必要があります。
Happier を初めて使う場合（概要と入手方法）
Happier を初めて見る方へ。Happier はコーディングセッション向けのオープンソースのコンパニオンアプリ（モバイル/Web/デスクトップ）です。
このガイドで大事な考え方はシンプルです。
- Auggie はリポジトリのあるコンピューターで動く
- Happier はスマホからセッションを見守る場所（進捗、承認、フォローアップ1つ）
セットアップ:
- GitHub: https://github.com/happier-dev/happier
- インストール/ダウンロード: https://github.com/happier-dev/happier#how-it-works
- Discord: https://discord.gg/W6Pb8KuHfg
ステップ 1: セッションを実行するコンピューターに Auggie をインストールする
プロバイダーのドキュメントより:
npm install -g @augmentcode/auggie
auggie --versionhstack を使っている場合は、インストーラーもあります:
hstack providers install auggie
auggie --version（hstack を初めて聞く方へ。Happier エコシステムの任意のヘルパーで、プロバイダーの CLI をインストールしてくれます。必須ではなく、npm install -g ... で問題ありません。）
大事なのはインストール方法ではありません。
セッションを実行するコンピューターで auggie --version が動くことです。
ステップ 2: Auggie の認証を理解する（ステータスが「不明（Unknown）」になる理由）
Auggie は、プロバイダー設定からネイティブのログインフローを起動できます。
ただし、Auggie の認証確認は控えめです。
Happier のエージェント認証確認の設定では、Auggie は unknown パーサーを使います。つまり:
- Happier はリスクのある確認で「ログイン済み」か「ログアウト」かを推測しない
- 問題がなくても UI に 不明（Unknown） と表示されることがある
そこで、よい目安は次のとおりです。
- そのコンピューターで
auggie loginが動けば問題ない - 「不明（Unknown）」は「壊れている」ではなく「安全に確認できない」と考える
実践的なログインチェックリスト
セッションを実行するコンピューターで:
auggie --versionを実行します。auggie loginを実行します（またはプロバイダー設定から起動します）。- 小さなセッションを1つ開始し、フォローアップを送れることを確認します。
一度これが動けば、壊れるまで認証のことは考えなくて大丈夫です。
ステップ 3: HAPPIER_AUGGIE_PATH で「Auggie が見つからない」を直す
セッション用のコンピューターでは auggie を実行できるのにアプリが見つけられない場合、原因はたいてい PATH です。
Happier はバイナリを上書きする環境変数に対応しています:
HAPPIER_AUGGIE_PATH
auggie 実行ファイルの絶対パスを設定してください。
この上書きは CLI バックエンドのテストで実際に検証されています（ドキュメント上の約束だけではありません）。
ステップ 4: セッションを開始し、スマホをモニターとして使う
スマホでのワークフローは、あえて狭くしています。
1つのループとして:
- セッションを開く
- 承認待ちになっていないか確認する
- フォローアップを1つ送る
- 離れる
スマホでやること（とやらないこと）
スマホでやってよいこと:
- 権限リクエストを読んだうえで承認または拒否する
- 短い修正を送る（「このステップで止まって」「X には触れないで」「先に要約して」）
- どのファイルが変わったかをざっと確認する
スマホでは避けたほうがよいこと:
- 大きなリファクタリング
- コピー&ペーストが多く必要な作業
- パスやコマンドを簡単に確認できない作業
Auggie で使いやすいコピー用フォローアップ3つ
「スマホから」の場面では、次のフォローアップを使い回す価値があります。
- チェックポイント
次のステップが終わったら止まって、次の内容をまとめてください:
- 変更した内容
- 変更していない内容
- 次にやりたいこと
- 制約
マイグレーションや認証には触れないでください。必要だと思ったら、止まって確認してください。
- 差分を先に
続ける前に、変更したファイルとその理由を挙げてください（各1文で）。
ステップ 5: トラブルシューティングのチェックリスト
セッションが更新されない
- コンピューターがオンラインで、セッションのランタイムが動いているか確認する
- 承認待ちになっていないか確認する
- セッションを再読み込みするか開き直す
ノートPCのふたを閉じていて、そのノートPCがホストなら、セッションは止まったと考えてください。
止まっているのか判断できない
「止まったセッション」の手順を使います:
- 承認待ちか、オフラインか、処理中か
Happier を初めて使う場合
Happier を初めて見る方へ。Augment/Auggie のようなセッションを1台のコンピューターで動かし、スマホから監視するためのオープンソースのコンパニオンアプリです。
ワークフローは基本的に次のとおりです。
- Auggie はリポジトリのある場所で動く
- Happier で進捗の確認、承認、フォローアップを行う
（別のアプリを増やしたくない場合は、いつでも SSH に戻れます。ただ、スマホでの SSH が好きな人は多くありません。）
セットアップ:
- GitHub: https://github.com/happier-dev/happier
- インストール/ダウンロード: https://github.com/happier-dev/happier#how-it-works
- Discord: https://discord.gg/W6Pb8KuHfg