---
title: Herdr での作業の進め方
description: Herdr をローカルで、SSH 内で、またはリモートアタッチで使います。
---

Herdr は作業がある場所で動かし、どこからでもアタッチします。

Herdr はバックグラウンドのセッションサーバーと、1 つ以上のターミナルクライアントで構成されます。ペインはサーバー内で動き続けます。クライアントはアタッチ、デタッチし、セッションを描画します。

## ローカルでの作業

プロジェクトディレクトリから Herdr を起動します:

```bash
herdr
```

Herdr はローカルのバックグラウンドセッションを自動的に起動するか、それにアタッチします。ソケットを管理する必要はありません。ペインの中でシェル、サーバー、テスト、エージェントを普段どおり実行してください。

`ctrl+b q` でクライアントをデタッチします。ペインは動き続けます。

あとで再アタッチします:

```bash
herdr
```

セッションを終了してペインを停止したい場合は、サーバーを停止します:

```bash
herdr server stop
```

## 通常の SSH 越しのリモート作業

コードと認証情報のあるマシンに SSH して、そこで Herdr を実行します:

```bash
ssh you@server
herdr
```

これはターミナルマルチプレクサと同じように動作します。シェルはリモート、Herdr サーバーもリモート、エージェントとペインはリモートマシン上で動きます。`ctrl+b q` でデタッチして切断し、あとで SSH し直して再び `herdr` を実行してください。

すでに SSH シェルの中で作業している場合、スマートフォンやタブレットの SSH クライアントを使っている場合、あるいは最もシンプルな構成にしたい場合はこの方法を使ってください。

## スマートフォンから作業する

Herdr のモバイルアプリや Web ダッシュボードは不要です。スマートフォンに任意の SSH クライアントを入れ、エージェントが動いているマシンに接続して、そこで Herdr を起動するだけです:

```bash
ssh you@server
herdr
```

同じ永続 Herdr セッションがスマートフォンのターミナルに開きます。TUI は狭い画面に適応するので、SSH から離れることなくエージェントの確認、ワークスペースの切り替え、ペインのチェックができます。

iPhone では [moshi](https://getmoshi.app/) のようなアプリがよく動作します。

<div class="mobile-doc-shots">
  <figure>
    <img src="/assets/mobile-agent-session-v2.jpeg" alt="スマートフォンで SSH 越しに表示した Herdr のエージェントセッション" loading="lazy" />
    <figcaption>SSH 越しのエージェントセッション</figcaption>
  </figure>
  <figure>
    <img src="/assets/mobile-switch-menu-v2.jpeg" alt="スマートフォンで表示した Herdr のレスポンシブ切り替えメニュー" loading="lazy" />
    <figcaption>レスポンシブな切り替えメニュー</figcaption>
  </figure>
</div>

## ローカルターミナルからのリモート作業

先にシェルを開かずに SSH 越しでアタッチします:

```bash
herdr --remote workbox
herdr --remote ssh://you@server:2222
```

ローカルの Herdr はシンクライアントとして動作します。SSH 越しに接続し、リモートの Herdr サーバーを起動またはアタッチして、UI をローカルターミナルにストリーミングします。

リモートセッションをローカルのように感じたいときはこの方法を使ってください。クライアントは手元のマシンで動くので、画像クリップボードの貼り付けのようなローカルデスクトップ機能をリモートサーバーにブリッジできます。先に SSH してサーバー上で `herdr` を実行した場合、Herdr は完全にそのサーバー上で動くため、ローカルデスクトップのクリップボードは読めません。

繰り返し接続する相手は SSH config に登録しておきましょう:

```text
Host workbox
  HostName server.example.com
  User you
  Port 2222
```

その後はこれでアタッチできます:

```bash
herdr --remote workbox
```

## どの方法を使うか

ローカル作業には `herdr` を使います。リモートシェル上で Herdr を tmux のように使いたいときや、スマートフォンの SSH クライアントを使っているときは `ssh you@server` してから `herdr` を使います。リモートセッション用のローカルシンクライアントが欲しいとき (ローカルクリップボードの画像貼り付けブリッジを含む) は `herdr --remote <host>` を使います。

リモートブートストラップの詳細、名前付きリモートセッション、カスタムバイナリ、ダイレクトターミナルアタッチ、`--no-session` については[永続化とリモートアクセス](/ja/docs/persistence-remote/)を参照してください。
