penso/herdr-gpui

Native client for Herdr on macOS, Linux, and Windows, built with Rust and GPUI. View terminal sessions, workspaces, Git worktrees, and agent activity through your local Herdr daemon.

概要

Herdr UI は、Herdr daemon と対話するためのネイティブデスクトップクライアント（RustとGPUIフレームワークで記述）です。Herdr daemon は、ターミナルベースのAIコーディングエージェント、ワークスペース、分割ペインを実行するバックグラウンドサービスです。別のターミナルエミュレータを開く代わりに、Herdr UI はデーモンのターミナルセルをグラフィカルウィンドウに直接描画し、リッチなサイドバー、タブ、分割ペインレイアウト、マウス/キーボード操作を追加します。

対象ユーザー

AI搭載コーディングエージェントを実行する開発者（コード作成、テスト実行、Webブラウジングなどを行うエージェント）で、それらを監視・制御するためのグラフィカルインターフェースを求める方。
複数のワークスペースやGit worktreeを利用するパワーユーザーで、ホストごとのCPU/メモリを確認し、ローカルとリモートのSSHマシンを切り替え、単一ペインからエージェントを管理したい方。
プレーンなターミナルUIよりもネイティブでクロスプラットフォームなUI（macOS、Linux、Windows）を好む方。

主な機能（READMEによる説明）

機能	説明
ターミナルレンダリング	デーモンのターミナルセル（分割ペインを含む）をUIに直接描画。追加のターミナルエミュレータは不要。
サイドバー	ホスト、ワークスペース、worktree、AIエージェントをステータスドット（アイドル、作業中、待機中）付きで表示。
Worktree管理	右クリックのポップオーバーで、worktreeの作成、名前変更、「テレポート」（移動）、チェックポイントの表示、削除が可能。
テレポート	worktree（未コミットの変更、開いているタブ、実行中のエージェントを含む）を別のSSHホストに移動。
エージェントレビュー	エージェントの変更の差分ビューを開き、行レベルのノートを追加し、フィードバックをエージェント（例：Claude）に送信。
ブラウザ統合	エージェントはGUI専用のブラウザタブでWebページを開くことができ、要素の注釈、ノートの追加、エージェントへの送信が可能。
複数レイアウトとテーマ	複数のサイドバー密度と、組み込みまたはGhosttyテーマ（ライト/ダーク、カスタム）のフルセットから選択可能。
AI使用量パネル	接続されたAIサービス（例：Claude）の使用制限を表示し、残高を確認可能。
システム監視	ホストごとのCPU・メモリのライブスパークラインを表示。リモートマシンではSSH経由で読み取る。
ネイティブ設定	テーマのライブプレビュー、検索可能なグリッド、フォント/インジケーター/サウンド設定。
リッチなターミナル操作	インライン画像、クリック可能なリンク、ファイルドロップ、コードナビゲーション（シンボルや`path:line`へのジャンプ）、エディタグループ、システム通知。
ドックバッジ（macOS）	エージェントがユーザーの注意を必要とするときにバッジを表示。

仕組み

Herdr daemonを実行（別途インストール）。デーモンがすべてのターミナルプロセス、ワークスペース、AIエージェントを管理します。
Herdr UIが接続 デーモンにローカルソケット（herdr-client.sock）を介してバイナリプロトコル（herdr-protocol）で接続します。
デーモンはサーフェスパッチ（ターミナルセルの更新）をUIにストリーミングし、UIはGPUIでレンダリングします。
ユーザー入力（キーボード、マウス、クリック）はデーモンに送り返され、適切なターミナルまたはエージェントに転送されます。
ブラウザタブはUIのみの機能で、デーモンは管理しません。エージェントはCLIコマンドでURLを開くことができ、UIとは別のローカルソケットで通信します。

インストールオプション

macOS – Homebrew cask（brew install penso/tap/herdr-gpui）。署名付きユニバーサルアプリとして開きます。
Linux – ディストリビューションに応じて適切な.deb、.rpm、またはArchパッケージを選択するスクリプト。プレーンなtarballとしても利用可能。
Windows – 実験的なPowerShellスクリプト。zip圧縮されたherdr-gpui.exeを%LOCALAPPDATA%\Programs\Herdr UIに配置します。
ソースから – just run（QAメニュー付き開発ビルド）またはjust install（Cargoのbinディレクトリにバイナリをインストール）。リポジトリはRust 1.96.1とGPUI 0.3.6に固定されています。

パフォーマンスと品質

専用のパフォーマンスベンチマーク（just test-perf）がフレームビルディングのレイテンシを測定。M4 Max Macでは、キャッシュ最適化後、ホバーのレイテンシが約51msから約12msに改善。
CIはmacOS、Ubuntu 24.04、Debian 13、Fedora 40、Archで実行され、パッケージインストール、ライブラリリンク、UIレンダリングをテスト。

ライセンス

Apache-2.0（ベンダリングされたherdr-protocolの追加通知を含む）。

Herdr UI は非提携のサードパーティクライアントであり、Herdr daemon自体を同梱・管理するものではありません。