Kiro は「本物の」コンピューターで動かされることが多いプロバイダーです。

• リポジトリのあるノートPC
• 開発用マシン
• サーバー

そして席を立った瞬間、誰もが同じことを求めます。

• まだ動いているか確認する
• 入力が必要か確認する
• フォローアップを1つ送る

ここで多くの人は SSH を使います。

このガイドはその代わりの方法です。リポジトリのある場所で Kiro を動かし、スマホから追いかけます。

要点

1. セッションを実行するコンピューターに Kiro CLI をインストールします（kiro-cli --version）。
2. kiro-cli login でログインします。
3. 認証ステータスを深読みしないでください。
   • Kiro の認証確認は控えめで、ログインできていても 不明（Unknown） と表示されることがあります。
   • 内部では、安全なステータスコマンドが使える場合、kiro-cli whoami --format json で確認しています。
4. スマホ向けのセッション UI でトランスクリプトを追い、承認に対応します。

課題

スマホからローカル CLI のセッションを追いかけるうえで大事なのは、主に次の2つです。

• セッションを実行するコンピューターへの安定した接続
• 「ログインしているか、準備できているか」を確実に把握すること

Kiro は認証確認が手動のみとして扱われるため、この点が特に厳格です。

そのため、ワークフローをはっきり決めておく必要があります。

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

• SSH: 使えますが、スマホでのターミナル作業になります。

• キーボードの前に戻るまで待つ: 安全ですが遅いです。

• Happier: コーディングエージェントをクロスデバイスで実行・オーケストレーションするためのオープンソースアプリです。セッションを追いかけ、承認に対応し、フォローアップを1つ送るためのスマホ UI を提供します。 トレードオフ: セッションを実行するコンピューターがオンラインである必要があります。

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

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

セットアップ:

• GitHub: https://github.com/happier-dev/happier
• インストール/ダウンロード: https://github.com/happier-dev/happier#how-it-works
• Discord: https://discord.gg/W6Pb8KuHfg

ステップ 1: Kiro をインストールする

プロバイダーのドキュメントに従い、次を確認します:

kiro-cli --version

ステップ 2: ログインする（マシンごと）

Kiro はマシンごとのログインを使います:

kiro-cli login

つまり:

• ノートPCでログインしても、サーバーにはログインされない

実践的なログインチェックリスト

セッションを実行するコンピューターで:

1. kiro-cli --version を実行します。
2. kiro-cli login を実行します。
3. アカウントを明示的に確認します:

kiro-cli whoami --format json

ユーザーやアカウントの情報が表示されれば、そのコンピューターでログインできています。

一度これが動けば、何か変わらない限り認証のことは考えなくて大丈夫です。

ステップ 3: 認証ステータスが「不明（Unknown）」になる理由を理解する

ソースでは、Kiro の認証確認は次のように定義されています:

• statusCommand: ['whoami', '--format', 'json']
• parser: 'kiroWhoamiJson'
• バックグラウンドでの確認: manual_only

最後の点が、「不明（Unknown）」がバグではない理由です。

バックグラウンドで積極的に確認しない、という安全のための方針です。

ステップ 4: スマホでのワークフロー

スマホのループは、あえて小さくしています。

1つのループとして:

1. セッションを開く
2. 承認待ちになっていないか確認する
3. フォローアップを1つ送る
4. 離れる

スマホでやること（とやらないこと）

スマホでやってよいこと:

• 承認
• 短い制約（「次のステップで止まって」「先に要約して」）
• 差分のざっとした確認

スマホでは避けたほうがよいこと:

• 大きなリファクタリング
• パスやコマンドを確認できない作業

Kiro で使いやすいコピー用フォローアップ3つ

1. チェックポイント

次のステップが終わったら止まって、次の内容をまとめてください:

• 変更した内容
• 変更していない内容
• 次にやりたいこと

2. 制約

マイグレーションや認証には触れないでください。必要だと思ったら、止まって確認してください。

3. 検証

続ける前に、これから実行するコマンドをそのまま貼り付けて、理由を説明してください。

セッションに本格的なターミナル操作が必要なら、キーボードの前に戻るまで待ちましょう。

Happier を初めて使う場合

Happier を初めて見る方へ。Kiro をカタログ定義の ACP プロバイダーとして実行でき、スマホからセッションを追いかけやすくするオープンソースのコンパニオンアプリです。

セットアップ:

• GitHub: https://github.com/happier-dev/happier
• インストール/ダウンロード: https://github.com/happier-dev/happier#how-it-works
• Discord: https://discord.gg/W6Pb8KuHfg

トラブルシューティング

ログインしたはずなのに Kiro がログアウト状態と表示される

• kiro-cli whoami --format json を実行する
• アカウント情報が表示されれば、ログインはできている

表示されない場合、そのコンピューターではログインしていません（別のコンピューターでログインしていても同じです）。

セッションが更新されない

• コンピューターがオンラインで、セッションのランタイムが動いているか確認する
• 承認待ちになっていないか確認する
• セッションを再読み込みするか開き直す

Kiro から stderr のノイズが出る

Happier は Kiro 専用のトランスポートを使い、既知の任意通知に関する「method not found」という stderr のパターンを抑制しています。

そのため、一度だけの警告なら無害な場合があります。

よくある質問

コンピューターによって認証の見え方が違うのはなぜですか？

Kiro のログインがマシンごとだからです。

コンピューターが複数あるなら、それぞれで kiro-cli login が必要です。

「手動のみ」の認証確認とはどういう意味ですか？

アプリがバックグラウンドで Kiro の認証状態を積極的に確認しない、という意味です。「不明（Unknown）」は安全なステータスで、必ずしも壊れているわけではありません。

関連ガイド

• Claude Code、Codex、OpenCode を自宅サーバーで動かし、スマホのブラウザから進捗を確認する方法