giuliastro/harness-remote

Harness Remote – AI コーディングエージェント向けのローカルファースト制御プレーン

概要

• 既存のAIコーディングエージェント (Codex CLI、Claude Code、OpenCode、Oh My Pi、PI) の上に配置される軽量な「リモコン」層です。これらのエージェントを置き換えるものではなく、エージェントが作成するネイティブセッションを検出し、エージェントやマシンをまたいで作業を観察、一時停止、再開、引き継ぎできるようにします。

重要性

• AIコーディングエージェントは、重いコンテキスト (モデル、ツール使用、認証情報、コード) をすべて自分のコンピュータに保持します。Harness Remoteを使用すると、デスクトップアプリ、Web/PWA、またはAndroidクライアントからこれらのセッションを管理でき、コードやプロバイダキーをクラウドサービスに移す必要はありません。

主な機能 (READMEに記載の通り)

機能	提供されるもの
ネイティブセッションが正本	基盤となるエージェントが、トランスクリプト、推論、ツール呼び出し、モデルの動作を引き続き所有します。Harness RemoteはUIと調整レイヤーのみを追加します。
クロスエージェント継続	あるエージェント (例: OpenCode) でタスクを開始し、元のプロジェクトIDを維持したまま別のエージェント (例: Claude) に引き継ぎます。
クロスマシン継続	別のコンピュータで同じプロジェクトを継続し、元のセッション系統を維持します。
ローカルファーストのセキュリティ	すべてのソースコード、認証情報、セッションデータは自分のマシンに留まります。ゲートウェイはLANまたはVPNの背後で実行でき、公開されることはありません。
検出と機能マトリクス	実行時にHarness Remoteは、実行中のエージェント (「ハーネス」) にサポートされているモデル、デフォルト、権限を問い合わせ、ハードコードしません。
マルチプラットフォームクライアント	• デスクトップアプリ (Windows/macOS、Electron) – 自動的にローカルゲートウェイを起動します。\n• Web/PWA – giuliastro.github.io/harness-remote でホストされるか、ローカルで実行されます。\n• Android – ゲートウェイのQRコードをスキャンして接続します。
簡単インストール	制御したいマシンにNode 20+をインストールし、サポートされているコーディングエージェントCLIがインストールされていることを確認して、npx harness-remote (またはGitHubショートカット) を実行します。
プロジェクト/ワークスペースビュー	マシン → プロジェクト → ネイティブセッションの順に表示され、すべてのアクティブなAIコーディングセッションを1つのペインで閲覧できます。

使用方法

1. ゲートウェイを起動 – コーディングエージェントCLIがすでにインストールされているコンピュータで実行します (npx harness-remote)。ゲートウェイはエージェントを検出し、ポートを選択し、一時的な認証情報を生成し、小さなデーモンを実行します。
2. クライアントを接続 – デスクトップ、Web、またはAndroidクライアントをそのゲートウェイに接続します (QRコードまたは手動アドレス)。クライアントにネイティブセッションのリストが表示されます。
3. 観察または制御 – エージェントの出力を監視し、新しいプロンプトを送信し、ターンを停止し、権限リクエストに回答し、別のエージェントまたはマシンで継続を作成します。
4. 後で再開 – ネイティブセッションは元のエージェントに保持されるため、クライアントを閉じ、ゲートウェイをシャットダウンし、後で再接続して中断したところから再開できます。

サポートされているエージェント (README時点)

• OpenCode 2 (ネイティブACPバックエンド、まだ検証中)
• OpenCode Legacy (v1) – HTTP + イベントストリーム
• Claude Code – ACPアダプタ
• Codex CLI – ACPアダプタ
• Oh My Pi – ACPアダプタ
• PI – ACPアダプタ

セキュリティ上の注意

• ゲートウェイは信頼できるLAN/VPN内でのみ到達可能にしてください。公衆インターネットに公開することを意図していません。
• --root は選択可能なプロジェクトとして表示されるファイルシステム領域を制限しますが、基盤となるエージェントは通常のOS権限で実行されます。

開発状況

• Apache-2.0ライセンスのオープンソース。
• リポジトリには、Node.jsデーモン、ブリッジテスト、Webクライアント (Vite)、Electronデスクトップラッパーが含まれています。各コンポーネントを実行するためのスクリプトが提供されています (npm start、npm run electron:dev など)。
• ドキュメントには、クイックスタート、アーキテクチャロードマップ、機能マトリクス、OpenCodeの信頼性契約が含まれています。

結論 Harness Remoteは、既存のAIコーディングエージェントにローカルファーストのマルチデバイスオーケストレーション層を追加する本格的なオープンソースツールであり、開発者はコードと認証情報をオンプレミスに保ちながら、リモート観察とクロスエージェント継続の利便性を得ることができます。