SII-Holos/synergyをREADMEから読み解く：構成、導入条件、運用上の境界

会話を越えて残る作業状態

Synergyはソフトウェアおよび知識作業のためのオープンソースワークスペースです。永続的で回復可能なAIエージェント作業と位置づけられ、セッション、エージェント、ファイル、ブラウザ、ツール、自動化を単一のランタイムで接続します。このプロジェクトは上海創新学院のHolosチームによって開発されています。TypeScriptで書かれ、ESMモジュールを使用するBunモノレポとして構成されています。リポジトリの説明では、オープンエージェンティックウェブのための次世代汎用エージェントと呼ばれていますが、READMEはローカルワークスペースとオプションのHolosエージェント接続に焦点を当てています。

Web・Desktop・CLIを同じ状態で使う

AIエージェントの作業はしばしば単一の会話より長く続きます。Synergyはそれを永続的なワークスペース状態として扱います。タスクは、プロジェクト、履歴、ファイル、ツール、操作コンテキストを保持しながら、Web、デスクトップ、CLI、バックグラウンド実行、専門エージェント間を移動できます。セッションは明示的なホームまたはプロジェクトスコープにアタッチされ、古いモデルコンテキストが圧縮されても完全な履歴が保持されます。READMEには、サーフェス全体での単一ランタイム、サブエージェントとブループリントによるファーストクラスのエージェント調整、ファイルとブラウザのコンテキスト保持、ライブラリとノートでの知識の蓄積などの機能がリストされています。

Blueprintと専門エージェントの分担

SynergyはWeb、デスクトップ、CLI、サーバーAPIとSDKを提供します。Webワークベンチは、セッション、プロジェクトファイル、ブラウザ、ノート、ライブラリ、アジェンダ、プラグイン、設定の主要サーフェスです。デスクトップアプリはElectron製品であり、管理されたパッケージサーバー、ネイティブブラウザプレゼンテーション、ローカルフォルダ選択、プロトコル処理、更新を備えています。CLIはランタイム管理、ワンオフsend実行、設定、セッション、統合、診断、開発ワークフローを処理します。サーバーAPIとSDKは、ファーストパーティクライアントと統合が使用する共有コントラクトを形成します。READMEはすべてのサーフェスが同じセッションと状態を使用すると述べています。

Agenda・Library・Notesの役割

デスクトップインストーラは、macOSでは.pkg、WindowsではNSIS .exe、Linuxでは.debとして公開されています。これらにはアプリが含まれ、パッケージ化されたランタイムをsynergy CLIとして公開します。ポータブルアーティファクトも公開されていますが、システムCLIを構成しません。CLIとWebの場合、READMEはcurlインストーラを提供しており、ランタイム、Web UI、スキーマアセットを~/.synergy/に配置します。SYNERGY_HOMEを設定するとそのルートが変更されます。インストール後、ユーザーはsynergy config wizard、synergy start、synergy webを実行します。ワンオフタスクはsynergy sendで送信できます。READMEにはstatus、logs、doctor、stopコマンドもリストされています。ヘッドレスブラウザツールにはChromiumが必要で、synergy browser installでインストールします。

ローカルワークスペースの拡張境界

SynergyはTypeScript ESMモジュールを使用するBunモノレポです。固定されたパッケージマネージャーはpackage.jsonで宣言されています。開発者はbun dev prepareを実行し、次にbun dev server、bun dev app --open、bun dev web、またはbun dev desktopを実行します。コアランタイムテストはpackages/synergyでbun testまたはbun run test:ciを使用して実行されます。フロントエンドスイートは標準スクリプトで実行され、bun run qualityに含まれます。ブラウザ機能の変更にはビルドとプライベートHTTPスモークテストが必要です。READMEはローカライゼーションも説明しています：フロントエンドのコピーは英語と簡体字中国語のカタログ、および疑似カタログに抽出され、変更はi18n:extractとlocalization:checkを実行します。Synergyを使用しながら開発する場合は、分離された2番目のインスタンスを開始することが推奨されています。

DeepSWE数値を読む際の前提

プラグイン作成者はリポジトリをクローンせずに始められます。READMEには、@ericsanchezok/synergy-plugin-kitを使用してtool-uiテンプレートからプラグインを作成し、ランタイムディスカバリでビルドおよび検証するコマンドが示されています。プラグインドキュメントはdocs/plugins/README.mdにあり、APIリファレンスはpackages/plugin/README.mdにあります。Synergyはまた、プロバイダー、ツール、スキル、コマンド、MCPサーバー、プラグイン、チャネル、リモートSynergy Linkターゲットの追加をサポートし、プロジェクトとデータのローカル所有権を保持します。READMEはコーディングエージェント向けのllms.txtと、リポジトリ変更向けのAGENTS.mdを指し示しています。

導入前に確認する実行経路

SynergyはMITライセンスの下でオープンソースです。ライセンスは、条件付きでコピーの使用、コピー、変更、統合、公開、配布、サブライセンス、販売の権利を許可します。保証と責任を明示的に否認します。READMEは貢献、バグ報告、機能アイデアを歓迎し、CONTRIBUTING.mdと行動規範を指し示しています。セキュリティ脆弱性は公開イシューではなく、リポジトリのセキュリティ報告プロセスを通じて報告する必要があります。リポジトリメタデータによると、Synergyには542スター、14フォーク、20のオープンイシューがあり、デフォルトブランチはdevです。

編集部の結論

SII-Holos/synergyは、READMEに書かれた構成と作業手順が自分の環境に合う人に向きます。公式説明だけでは性能、障害時の復旧、運用負担までは判断できないため、devブランチのREADMEにある具体的なコマンドと設定を小さな検証環境で確認してください。特にこのプロジェクト固有の入力、保存先、権限、外部サービスとの境界を記録し、合わない条件を先に除外するのが妥当です。

公式情報源

1. Official README
2. Project repository
3. Release notes