5分でインストール

このガイドでは、スマートフォンからCollieを使えるようにセットアップします。PCに3つのツールをインストールし、Collieを起動して、スマートフォンをペアリングします。

入口としてTailscale、マルチプレクサとしてHerdrを使い、インストールスクリプトを実行する推奨手順を説明します。その他の構成についてはインストールを参照してください。

注。 Collieの設計上、PCへのリモートシェルアクセスが許可されます。インストールする前にセキュリティをお読みください。

必要な環境

• —
  LinuxまたはmacOSのPC（ホスト）。Macの場合はApple SiliconおよびmacOS 13以降が必要です。
• —
  iPhoneまたはAndroidスマートフォン。
• —
  Tailscaleアカウント。

1. Tailscaleをインストールする

Tailscaleはホストとスマートフォンを1つのプライベートネットワーク（tailnet）で接続します。Collieにはこのネットワーク経由でのみアクセスできます。

Linuxホストの場合:

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up --operator=$USER

--operator=$USERを実行すると、Collieがステップ4で必要とするtailscale serveをユーザーが実行できるようになります。

Macでは、tailscale.com/downloadからTailscaleをインストールしてサインインします。アプリの設定からtailscaleコマンドをインストールしてください。Collieがこのコマンドを呼び出します。

次に、tailnetとスマートフォンを設定します:

1. 01
   admin consoleを開き、Enable HTTPSを選択します。Collieの動作に必要です。
2. 02
   スマートフォンにTailscaleアプリをインストールします。同じアカウントでサインインしてください。

2. Herdrをインストールする

Herdrは、接続が切断された場合でもホスト上でターミナルペインとコーディングエージェントを実行し続けます。Collieはこれらのペインをスマートフォン上に表示します。

curl -fsSL https://herdr.dev/install.sh | sh    # or: brew install herdr
herdr

Herdrによってペインが開きます。そのペイン内でclaudeなどのエージェントを起動してください。Herdrは実行したままにしておきます。

3. Collieをインストールする

ホストで2つ目のターミナルを開き、インストールスクリプトを実行します:

curl -fsSL https://colliepwa.dev/install.sh | sh

スクリプトはcollieバイナリを~/.local/binに保存します。sudoは使用しません。シェルがcollieを見つけられない場合は、~/.local/binをPATHに追加してください。詳細はスタンドアロンに記載されています。

4. Collieを起動する

COLLIE_MUX=herdr collie start

startはバックグラウンドでCollieを実行し、tailscale serveを使用してtailnet上に公開します。また、マルチプレクサとしてherdrを保存します。次回以降の実行ではcollie startのみで起動できます。準備が整うとCollie は実行中ですが出力され、tailnetの行にURL（例: https://myhost.tail1234.ts.net）が表示されます。

SSHで接続しているリモートのLinuxホストで、ログアウト後もCollieを実行し続ける場合:

loginctl enable-linger $USER

5. スマートフォンにCollieを追加してペアリングする

collie qr

1. 01
   スマートフォンのカメラでQRコードをスキャンし、ブラウザでCollieを開きます。
2. 02
   アプリのように全画面で開くよう、Collieをホーム画面に追加します。 - iPhone: Safariで共有をタップし、ホーム画面に追加をタップして、追加をタップします。 - Android: ChromeでCollie 設定を開き、一番上のカードにあるインストールをタップします。
3. 03
   新しく追加されたアイコンからCollieを開きます。
4. 04
   ホスト側でcollie pairを実行すると、10分間有効な8文字のコードが表示されます。
5. 05
   Collieで設定 → システム → ペアリング済みデバイスを開きます。
6. 06
   コードと名前（例: my phone）を入力し、このデバイスをペアリングをタップします。

ブラウザのタブではなく、ホーム画面のアクションから追加したアプリ内でペアリングしてください。iPhoneでは、ホーム画面のアプリはSafariとは独立した独自のストレージを保持します。Safariで行ったペアリングは引き継がれません。

1台のデバイスがペアリングされると、ペアリング済みデバイスのみがペインに入力できるようになります。それまでは、tailnet上のすべてのデバイスから入力可能です。startの直後にペアリングを行ってください。他のユーザーと共有しているtailnetでは、COLLIE_TRUSTED_USER（設定）も設定してください。

ダッシュボードにはHerdrペインが一覧表示されます。入力を待機しているペインが先頭に並びます。ペインをタップすると出力を確認し、返信できます。

次のステップ

• —
  tmuxまたはHerdr上のClaude Codeをスマートフォンから操作するでは、Claude Codeを使用した1日の利用フロー全体を説明します。
• —
  Web Pushでは、エージェントが入力を必要とするときに通知を送る設定を追加します。
• —
  設定では、COLLIE_TRUSTED_USERを使用してCollieをtailnetユーザーのみに制限する方法を説明します。
• —
  トラブルシューティングでは、よくあるエラーについて説明します。