Agentty/ドキュメント

リモートアクセス

Tailscale ネットワーク上の別のデバイスのブラウザから Agentty ワークスペースを開く。

リモートアクセスを使用すると、別のデバイス — スマートフォン、タブレット、または別のコンピュータ — のブラウザから Agentty ワークスペースを開くことができます。自分の Tailscale ネットワーク内から、ローカルネットワークでターミナルセッションを表示し、コマンドを直接入力し、エージェントにプロンプトを送信できます。

画面に表示されるもの#

ページは Agentty アプリと同じ構成です。

  • ホーム — ページを開くと最初に出る画面です。回答を待っているターミナルと作業中のターミナルの数、待っているターミナルとその質問、作業中のエージェント、すべてのワークスペース(休止中のものも)、プラグインとその状態がひと目でわかります。ターミナルやワークスペースをタップするとそこへ移ります。☰ メニューの一番上の ホーム で戻ります。
  • ☰ メニュー — グループとワークスペースがサイドバーと同じ順序・色で、ブランチとフォルダと一緒に表示されます。赤い数字は、そのワークスペースで回答を待っているターミナルの数です。広い画面では左側に常に開いています。
  • タブ — 選んだワークスペースのタブが上に並びます。点は作業中または回答待ちのタブ、▥2 は 2 つのペインに分割されたタブです。
  • 分割ペイン — タブが分割されていると、右上のボタンでペインの一覧を開き、各ペインの状態と質問を見て、タップで切り替えます。
  • ターミナル — 中央に、選んだペインのライブ画面が表示されます。
  • チャットワークスペース — チャットワークスペース はチャットとして開きます。会話、プランの使用量、リードへの入力欄が表示され、ターミナル でリードのターミナルに切り替えられます。
  • 出力の中のファイル — ターミナルやチャットに出たファイルパス(shots/home.png、NOTES.md、src/app.ts)には下線が付き、タップするとページ上のビューアでファイルごとにタブで開きます。画像はそのまま、Markdown はレンダリングして、その他のテキストはテキストとして表示し、PDF は別のタブで開きます。開けるのはそのターミナルのプロジェクトフォルダ内のファイルだけで、隠しファイル(.env、.git など)と鍵ファイルは開きません。

新しいタブ — タブの最後の +(またはホームのワークスペースの横の +)で、そのワークスペースにターミナル、Claude Code、Codex のいずれかで新しいタブを開きます。ワークスペースのフォルダで始まり、ページはそのタブに移ります。

新しいワークスペース — ホームのワークスペース一覧の下や ☰ メニューにある + 新しいワークスペース から、Mac の ~/AgenttyRemote の中のフォルダで新しいワークスペースをターミナル、Claude Code、Codex のいずれかで開きます。フォルダをたどるか新しく作り、起動するものを選ぶとページがそこへ切り替わります。ページから ~/AgenttyRemote の外のフォルダには届きません。このフォルダは最初に使うときに Agentty が作り、リモートアクセスのページの Finder で表示 で Mac 上で開けます。

休止中のワークスペース — Agentty で休止中のワークスペースには 起こす が表示されます。押すと保存されたタブがまた始まり、ページに表示されます。どちらも Mac の画面に表示されている内容は変えません。

プラグイン — ホームに、インストール済みのプラグインとその状態(実行中、停止、エラーで停止)、各自動化がいま何をしているかが表示されます。表示するだけです。プラグインのワークスペースはページでは開かず、ページからプラグインを起動・停止することはできません。

画面のキーバーを使用して、Esc、Tab、Shift+Tab、矢印キー、Enter、Ctrl+C、スティッキー Ctrl キー、および エージェントが回答を要求するときのクイックボタン(1/2/3) で、ターミナルに直接入力できます。または、下部のボックスからプロンプトを送信できます。コンピュータ では Enter を押し、行を追加するには Shift+Enter を押します。

画像 — ボックスの横の画像ボタンで写真やスクリーンショットを添付できます。ボックスに貼り付けたりドロップしたりしても構いません。画像は次のプロンプトと一緒に送られ、Mac でターミナルにドロップしたのと同じ扱いになるので、Claude Code や Codex が画像として読みます。大きな写真はスマートフォン側で先に縮小されます。Mac は画像を Agentty のデータフォルダに 1 週間保管し、あなただけが読めます。

ページの通知を受け取るを押すと、ページを開いたまま別の作業をしている間にセッションが完了したり応答を求めたりしたとき、ブラウザ通知が届きます。

ページでターミナルを表示している間、ターミナルはページの大きさに合わせられます。画面に収まるだけの列と行を使うので、行が折り返されたり横にスクロールしたりしません。A− と A+ で文字サイズを変えられます(端末ごとに保存)。どのページもそのターミナルを表示しなくなると、アプリでの元の大きさに戻ります。このページをホーム画面にアプリとして追加できます。

Slack・Discord・Telegram の通知を設定している場合(設定 → 連携)、リモートアクセスがオンの間はメッセージの下に 今すぐ確認: <アドレス> が付きます。このアドレスを開くと、Tailscale と Web パスワードの確認の後、そのターミナルが直接開きます。 このアドレスには Mac と tailnet の名前が含まれるため、エージェントの質問内容を含める がオンのときだけ送ります。

必要なもの#

次が必要です。

  • Tailscale Mac にインストールされ、接続されている (別のデバイスも同じ Tailscale アカウントでサインインしている)
  • MagicDNS と HTTPS 証明書 tailnet で有効になっている (Tailscale 管理コンソール → DNS)
  • Tailscale Serve tailnet で許可されている — そうでない場合、Agentty はオンにするボタンを表示します

セットアップ#

  1. サイドメニューの リモートアクセス(地球儀とモニターのアイコン)を開く
  2. Web パスワード を設定 (英字・数字・記号で 12 文字以上、2 回入力。目のボタンで入力内容を表示できます)
  3. オンにする前に の 証明書を発行 を押す: Tailscale がこのコンピュータの HTTPS 証明書を取得します (コンピュータごとに一度。初回は1分ほどかかることがあり、更新は Tailscale が自動で行います)
  4. リモートアクセスをオン にする — オンにする前に の手順がすべてチェックされるとオンにできます
  5. 表示されたアドレスをコピーする (https://<machine>.<tailnet>.ts.net:8743/) か、オープン をタップしてそこに直接移動する
  6. 別のデバイスで Web パスワードでサインインする

これで完了です。セッションがそのデバイスで表示されるようになりました。

Tailscale が検出されないとき#

オンにする前にの最初の手順に、何が問題かと解決のボタンが表示されます。画面が自動で再確認するので、解決すれば何も押す必要はありません。

表示すること
インストールされていないTailscale を入手。インストールしたばかりなら、一度アプリを開いてください。
この Mac でオフTailscale を開くを押して Connect をオンにします。macOS が VPN の追加やシステム拡張の許可を求めたら許可してください。
サインインしていないサインイン。スマートフォンでも使うアカウントでサインインしてください。
承認待ちMachines ページでこのデバイスを承認するか、tailnet の管理者に依頼してください。
バックグラウンドサービスが応答しないTailscale を開いて初回設定を完了してください。Mac はシステム設定 → 一般 → ログイン項目と拡張機能でシステム拡張を許可し、Windows はコンピューターを再起動します。Linux は sudo systemctl enable --now tailscaled と sudo tailscale up を実行します。
macOS が許可を待っているシステム設定 → 一般 → ログイン項目と拡張機能 → ネットワーク機能拡張で Tailscale をオンにしてください。
別の VPN が妨げている可能性表示された VPN を切断してから、Tailscale で Connect をオンにしてください。
この Mac アカウントに権限がないTailscale のアクセスファイルを読めるのは管理者アカウントだけです。管理者アカウントを使うか、システム設定 → ユーザとグループで管理者権限を与えてください。
Tailscale がこのアカウントを拒否Linux は sudo tailscale set --operator=$USER を一度実行します。Windows は別のアカウントが Tailscale を使っている可能性があります。会社が管理する Mac はポリシーで制限されている可能性があります。
応答を読み取れないTailscale を終了して開き直すか、更新してください。Tailscale のエラーメッセージが案内の下に表示されます。

それでも解決しないときはエージェントに任せるを押します。見つかった内容を受け取ったエージェントが新しいタブでまず確認だけを行い、何かを変更する前に尋ねます。診断内容をコピーは同じ要約をコピーします。含まれるのはバージョンと状態だけで、アカウント、マシン、tailnet の名前は含まれません。

どのアカウントが必要ですか? どの Tailscale アカウントでも使えます。Apple アカウントやコンピューターのユーザーアカウントと同じである必要はありません。同じにする必要があるのは、このコンピューターと接続する端末の Tailscale アカウントです。

セキュリティ#

リモートアクセスは Tailscale ネットワーク内からのみ到達可能です — 公開インターネットには決してありません。Funnel がそのポートに対してオンになっている場合、Agentty は実行を拒否します。入るには次の 2 つをどちらも通る必要があります。

  1. Tailscale アカウント — この Mac の持ち主のアカウントだけが入れます。tailnet を共有する他の人やタグ付きデバイスは拒否されます。
  2. Web パスワード — リモートアクセス画面で決めたパスワード。

ほかの人の Tailscale アカウントは、同じ tailnet 内でも入れません。あなたの Tailscale アカウントでサインインした端末で Web パスワードも通った場合にだけターミナルに入力でき、Mac でコマンドを実行できることになります。Web パスワードは誰とも共有せず、他で使っていないものにし、不要なときはリモートアクセスをオフにしてください。

Agentty のページに届くのは Tailscale だけです。Agentty は Tailscale の serve だけが入れる場所で待ち受けます。Tailscale が開ける場合は専用ソケット、そうでなければ Tailscale にだけ伝えた秘密のパス付きのローカルポートです。そのため Mac 上の他のプログラムや他のユーザーアカウントは直接入れません。ページは Tailscale が動いている間だけ動作します。Tailscale が切断・サインアウト・終了すると数秒以内にページを止め、再接続されると自動で再開します。オンの間は 30 秒ごと(と Mac のスリープ解除時)に、Tailscale 経由でページが応答するかも確認します。応答がなければ、オフにしてオンに戻したのと同じようにリモートアクセスを自動で再起動し、ページでは Web パスワードをもう一度入力します。

サインイン試行の失敗は速度制限されます。5 回のパスワード誤入力後、1 分間ロックされます。ロック後の各パスワード誤りは待機時間を 2 倍にし、最大 1 時間です。デバイスがサインインしたときとページがロックされたときに、デスクトップ通知が表示されます。 自分でロックしたのでなければ、リモートアクセス画面の ロック解除 ですぐに解除できます。

パスワードはシステムキーチェーンにハッシュとしてのみ保存されます。サインインは最大 7 日間 (アイドル 12 時間) 続きます。Agentty を終了したり、パスワードを変更したり、すべての端末でサインアウト をタップすると、すべてのデバイスが一度にサインアウトします。

起きたままにする#

リモートアクセスがオンの間、Agentty は Mac がアイドルスリープに陥らないようにして、到達可能に保ちます。ディスプレイはまだスリープに入る可能性があります。必要に応じてこれをオフにできます。

スリープ状態の Mac または閉じたノートパソコンには到達できません。

リモートアクセスは再起動後も有効なままになり、オフにするまで続きます。Tailscale ポート 8743 を使用し、Tailscale で提供する他の何にも干渉しません。他のものが既にポート 8743 を使用している場合、Agentty はエラーを表示します。

Mac アプリでの音声入力#

アプリの中でもそのまま話して指示できます。 マイクはエージェントのタブ(Claude Code、Codex など)とチャットでだけ表示されます — 普通のシェルでは話したプロンプトの使い道がないためです。 エージェント CLI にも独自の音声機能があります。Claude Code の /voice はプロンプトに書き起こし(Space を長押し。音声は Anthropic のサーバーで文字起こしされ、claude.ai へのサインインが必要)、Codex の /voice は書き起こしではなく、Codex が声で答える音声での会話です。Agentty のマイクはどのエージェントでも、チャットやリモートページでも同じように動き、音声を Mac の外に出しません。ステータスバー右端のマイクをクリックするか ⇧⌘M を押して話してください。聞いている間、ステータスバーに録音中 0:05と音量メーターが表示されます。

  • ⏎ Enter — 停止して、話した内容をターミナルへすぐプロンプトとして送信します。
  • マイクをもう一度クリック、または ⇧⌘M — 停止して入力だけします。確認・修正してから送信してください。
  • Esc — 録音を取り消します。

内容は録音を始めたときにアクティブだったターミナルに入ります。言語は音声から自動判定されるので、日本語・英語・混ぜた話し方のどれでも使えます。初回は macOS がマイクへのアクセスを求めます。オフにしている場合は、Agentty がシステム設定のマイク画面を開きます。モデルがまだない場合は、マイクを押すとその場でモデルのセットアップ(下と同じもの)が開きます。

音声でプロンプトを送る#

リモートページでは、入力する代わりに音声でプロンプトを送れます。プロンプトバーのマイクをタップして話し、もう一度タップして止めると、文字起こしされた内容が入力欄に入ります。確認してから送信してください。

音声はこの Mac でローカルモデルによって文字起こしされ、外部のサービスには送信されません。モデルは 設定 → 音声入力 から一度だけインストールします(リモートアクセスの画面にも同じカードがあります)。Large-v3 Turbo(おすすめ、約 574 MB)または軽い Small(約 488 MB)を選ぶと Mac にダウンロードされ、検証のうえ保存され、Mac の GPU で動きます。同じ場所で話す言語(自動・韓国語・英語 — 自動判定は短い発話を別の言語と取り違えることがあります)を選び、使うモデルを決め、モデルを削除できます。モデルを入れると、リモートページにマイクボタンが自動で表示されます。

初回はブラウザがマイクの許可を求めます。ページは HTTPS で配信されている必要があります(Tailscale 経由で HTTPS です)。

開発サーバー#

ワークスペースのターミナルでローカルサーバー(npm run dev、rails s、静的サイトのプレビューなど)を動かすと、ページのワークスペースのタブの下にそのポートが ↗ localhost:3000 のように表示されます。タップすると、新しいブラウザタブで https://<machine>.<tailnet>.ts.net:3000/ としてサーバーが開きます。ページと同じアドレス名にサーバーのポートを付けたものです。初回は Tailscale がポートを準備するため数秒かかります。

ページと同じく、入れるのはあなただけです。そのアドレスは Agentty 自身が受け、あなたの Tailscale アカウントで、かつウェブパスワードでサインインした端末からのリクエストだけをサーバーに渡します(先にページでサインインしてください)。サーバーからはリクエストが localhost:<ポート> 宛てに見え、Agentty のサインイン情報は渡りません。Mac のブラウザで開くのと同じように動き、ホットリロードも使えます。

サーバーが止まったとき、リモートアクセスをオフにしたとき、Agentty を終了したときにアドレスは消えます。Tailscale が既に別の用途で使っているポートや、Funnel で公開されているポートは開かず、ページに理由を表示します。

スマートフォンアプリから送ったワークスペース#

Agentty Remote アプリで、スマートフォンからワークスペースを送れます。送ったワークスペースは自分の名前で、専用のグループの中に開きます。一緒に送ったファイルはワークスペースのフォルダの .agentty-remote/ に保存され、git には入りません。リモートアクセスのページの サインイン中の端末 では、アプリでサインインしたスマートフォンはブラウザ名ではなく Agentty Remote と表示されます。

アプリからは、ワークスペースをスリープさせる、タブを閉じる(分割したペインごと閉じ、閉じたタブから開き直せます)、ワークスペースをゴミ箱に移す、といった操作もできます。スマートフォンからの操作で完全に消えるものはありません。スマートフォンからゴミ箱に移したワークスペースはワークツリーと同期データをそのまま残し、ほかの項目と同じくゴミ箱から元に戻せます。

スマートフォンアプリからのチャットとオーケストレーション#

Agentty Remote アプリは、ペインをチャットとして表示し、オーケストレーションを追うことができます。サインインと確認はページと同じです。スマートフォンでチャットを選んでも、Mac でのペインの表示は変わりません。スマートフォンからオーケストレーションを開始または再開しても Mac は表示中のワークスペースのままで、トーストで知らせます。

リモートアクセスから外したワークスペースとその中のオーケストレーションは表示されません。スマートフォンから開始したオーケストレーションは ~/AgenttyRemote の下のフォルダで作業し、Mac のダイアログのように目標に書かれたリンクやファイルを先に読むことはありません。エージェントは目標だけを受け取ります。

会話にはエージェントが読んで出力したものがすべて含まれます。Mac を離れる前にホームフォルダは ~ に短縮され、既知の形式の認証情報に見える文字列は隠されます。よくある形式だけを捉えるものなので、すべて隠れるとは考えないでください。ターミナルと同じセッションです。

機能を隠す#

リモートアクセスを使わない場合は、設定 → 一般 → リモートアクセス機能を使う をオフにするか(既定はオン)、リモートアクセス画面の リモートアクセスを無効にする を押します。サイドメニューからアイコンが消え、リモートアクセスもオフになります。設定をオンに戻すと再び表示されます。

特定のワークスペースだけをページから外すには、そのカードのメニュー (右クリック) で リモートアクセスで非表示 を選びます。ページの一覧から消え、そのターミナルにも届かなくなります。

トラブルシューティング#

Tailscale が接続されていない Mac の Tailscale アプリで接続してください。

HTTPS 証明書がオフ Tailscale 管理コンソール (DNS 設定) で MagicDNS と HTTPS を有効にしてください。これで tailnet ドメイン用の証明書が作成されます。

オンにできませんでした: Tailscale can't reach Agentty's page このコンピュータの HTTPS 証明書がまだなかったことがよくあります。リモートアクセスをオフにし、証明書を発行 を押してから、もう一度オンにしてください。

Serve がオフ Agentty は設定で Serve をオンにするボタンを表示します。タップして Tailscale 管理コンソールを開きます。

この Tailscale アカウントはこの Agentty を使用できません (サインインページに表示) 別のデバイスが別の Tailscale アカウントでサインインしています。Mac と同じアカウントでサインインしてください。

ページに「ロック」と表示 (サインインフォームの代わりに表示) パスワードを 5 回間違えたか、他の誰かが間違えた可能性があります。待つか、リモートアクセス → 最近のアクティビティ をチェックして何が起こったかを確認してください。 自分でなければ、Mac のリモートアクセス画面で ロック解除 を押してください。