herdr

このリポジトリ · インストール · クイックスタート · ドキュメント

日本語 · English · 简体中文

---

v.0.4.0.mp4

コーディングエージェントが住むランタイム。

このリポジトリ（kuwa2005/herdr）は herdrdev/herdr の 日本語寄りフォークです。UI 言語（en / ja / zh-cn）やローカル向け修正を載せています。upstream の有用な更新は必要に応じて取り込みます。内部運用は FORK.md を参照してください。

• 閉じても作業は止まらない — クライアントを閉じたり SSH が切れても、バックグラウンドサーバー上でターミナルが動き続けます。サーバーやマシン再起動後は保存済みレイアウトを復元し、対応エージェントは再開できます（元プロセスは残りません）。セッション状態 →
• 複数マシンを一つの窓で — ローカルと保存済み SSH を並べ、エージェント一覧をまとめ、接続ごとに独立して再接続できます。リモートマシン →
• 止まっているエージェントを探し回らない — 各ペインは working / blocked / idle。回答待ちになると Herdr が知らせます。
• エージェントネイティブ — CLI と socket API でペイン作成・相互プロンプト・本当に blocked になるまでの待機ができます。エージェントスキル →
• いま使っているものをそのまま — Claude Code、Codex、Cursor、OpenCode、Grok など。ラップせず、ターミナルを所有します。
• キーボードもマウスも一等 — tmux 風プレフィックスと、クリック・ドラッグ・分割の両方。
• プラグイン — ペインとワークフローを拡張。マーケットプレイス →
• Rust 単体バイナリ、Electron なし — いつも使っている端末で動きます。

---

インストール

インストーラ・配布バイナリ・herdr update のマニフェストは、すべて このリポジトリ（kuwa2005/herdr）の GitHub Releases / distribution/*.json を使います。

Linux / macOS

curl -fsSL https://raw.githubusercontent.com/kuwa2005/herdr/master/distribution/install.sh | sh

Windows（PowerShell）

PowerShell を開き、次を実行します。

powershell -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/kuwa2005/herdr/master/distribution/install.ps1 | iex"

インストール後:

1. 新しい PowerShell ウィンドウを開く（PATH 反映のため）
2. herdr と入力して起動を確認する

チャネルを明示する／引数を付けたい場合は、いったん保存してから実行します。

irm https://raw.githubusercontent.com/kuwa2005/herdr/master/distribution/install.ps1 -OutFile install.ps1
powershell -ExecutionPolicy Bypass -File .\install.ps1 -Channel stable
# プレビューの場合: -Channel preview
Remove-Item .\install.ps1

Windows（エンドポイント保護で PowerShell がブロックされる場合）

コマンドプロンプト（cmd） で次を実行します。

curl.exe -fsSLo install.cmd https://raw.githubusercontent.com/kuwa2005/herdr/master/distribution/install.cmd && install.cmd && del install.cmd

その他の入手方法

方法	コマンド / リンク
Homebrew	brew install herdr
mise	mise use -g herdr
バイナリ直リンク	Releases（このリポジトリ）
ソースビルド	下記「開発」

作業ディレクトリで起動:

herdr

エージェントを走らせ、ペインを分割し、離れても大丈夫です。ctrl+b q でデタッチ、herdr で再アタッチ。クイックスタート →

UI を日本語にする例（~/.config/herdr/config.toml）:

[ui]
language = "ja" # en | ja | zh-cn

グローバルメニューの language、または設定の language タブからも切り替えられます。

付属ツール

タブ／ペイン要約（summarize_herdr_tabs）

Herdr 上のタブとペインが いま何をしているか を、エージェント検出や直近の出力から要約します。

just tabs-summary
# または
python3 scripts/summarize_herdr_tabs.py

主なオプション（python3 scripts/summarize_herdr_tabs.py --help）:

オプション	説明
--format plain / markdown / json	出力形式（既定: plain）
--workspace ID	対象ワークスペースを限定（繰り返し可）
--lines N	トランスクリプトが無いときの直近行数（既定: 120）
--include-shell	エージェント未検出のペインも含める

ドキュメント

公開ドキュメントは herdr.dev/ja/docs を参照してください。
クイックスタート · 概念 · 対応エージェント · キーボード · 設定 · セッション状態 · マシン接続 · リモート · 連携 · プラグイン · Socket API

upstream について

• 製品本体・公式ドキュメント・リリースバイナリの本家は herdrdev/herdr / herdr.dev です。
• この fork では日本語 UI やローカル向け修正を優先します。upstream の有用な更新は、必要に応じて取り込みます。
• 本家への実装 PR は、Herdr の貢献ポリシー（承認コントリビュータのみ）に従ってください。

スポンサー一覧は SPONSORS.md（upstream 由来）。企業・提携: hey@herdr.dev

エージェント向け

このリポジトリを触る AI エージェントは、変更前に AGENTS.md を、Issue / PR 前に CONTRIBUTING.md を読んでください。

開発

git clone https://github.com/kuwa2005/herdr
cd herdr
cargo build --release

just test        # ユニットテスト
just check       # フォーマット・テスト・メンテ用チェック

upstream を取り込む例:

git remote add upstream https://github.com/herdrdev/herdr.git   # 初回のみ
git fetch upstream
git merge upstream/master   # または rebase。方針に合わせて選択

ライセンス

Herdr は Apache License 2.0 です。