コンピューターで Pi Coding Agent が動いているとき: スマホから監視する方法

Pi Coding Agent 向けのプロバイダー別ガイド。インストール、環境変数ベースの認証、連携サービスのプロファイル、スマホからの確認とフォローアップの流れを解説します。

対象バージョン

Pi Coding Agent は、「本物の」コンピューターで動かすのが向いているツールです。

そして、いつもの願いが出てきます。

スマホから様子を見たい。

リファクタリング全体をやりたいわけではありません。

やりたいのは:

このガイドは、それを無理なく行えるようにするプロバイダー別のワークフローです。

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

スマホからの SSH
リモートデスクトップ
待つ
Happier: 進捗の確認、承認、フォローアップ1つのためのスマホ UI を提供します。トレードオフ: セッションを実行するコンピューターがオンラインである必要があります。

Happier を初めて見る方へ。Happier はコーディングセッション向けのオープンソースのコンパニオンアプリ（モバイル/Web/デスクトップ）です。

セットアップ:

セッションを実行するコンピューターに Pi をインストールします（pi --version）。
Pi の認証は環境変数ベースです（対話型のログインフローはありません）。
連携済みの認証情報に対応した仕組みを使っている場合は、互換性のあるプロファイルを選びます（OpenAI Codex サブスクリプションの OAuth、OpenAI API キーなど）。
Pi が検出されない場合は、HAPPIER_PI_PATH に pi バイナリの絶対パスを設定します。
スマホ向けのセッション UI で監視、承認、フォローアップを行います。

Pi は、アプリ内に「ログイン」の手順がない点で多くのプロバイダーと異なります。

これはバグではありません。

認証情報のモデルです。

そのため、スマホでのワークフローは「スマホからログインする」ではありません。

次のようになります。

プロバイダーのドキュメントより:

npm install -g @mariozechner/pi-coding-agent
pi --version

または hstack で:

hstack providers install pi
pi --version

（hstack を初めて聞く方へ。Happier エコシステムの任意のヘルパーで、プロバイダーの CLI をインストールしてくれます。必須ではなく、npm install -g ... で問題ありません。）

Pi は「認証情報はチャット UI ではなくコンピューターにある」ことを示すわかりやすい例です。

ソースでは、Pi の認証確認は piEnvOnly と指定されています。

想定すべき動作は次のとおりです。

Pi を実行するコンピューターで:

pi --version が動くことを確認します。
使う認証情報の種類を決めます:
- OpenAI Codex サブスクリプションの OAuth（連携済み）
- OpenAI API キー
- Anthropic API キー
- Claude サブスクリプションの setup-token プロファイル（OAuth ではない）
小さなセッションを1つ開始し、フォローアップを送れることを確認します。

一度これが動けば、スマホでのワークフローはシンプルです。監視して、承認して、後押しするだけです。