SII-Holos/synergy

Synergy – Persistent, recoverable AI‑agent workspaces

What it is – An open‑source, local‑first platform that lets you run AI agents (LLMs, tool‑using bots, specialist sub‑agents) inside a durable workspace. All the state – session history, project files, a built‑in browser, notes, and reusable “Library” memory – lives on disk and can be resumed across restarts, devices, or different front‑ends (Web UI, Electron desktop app, CLI, or server API).

Why it matters – Typical LLM‑agent demos disappear after a single chat. Synergy treats an agent’s work as a long‑running project, preserving context, files, and learned knowledge so you can pick up where you left off, schedule recurring runs, or chain multiple agents together.

Core concepts

Concept	What it does
Scope / Home	An explicit project container that owns sessions, files, and history.
Agenda	Calendar view for scheduling one‑off or recurring agent runs; shows run history.
Library	Durable memory store that records evaluated experiences, with reward‑signal analytics per behavior dimension.
Notes & Blueprints	Agents can write searchable notes or reusable “Blueprint” documents that describe plans or code snippets.
Plugins / Skills	Extensible catalog of tools, commands, or UI components that agents can invoke.
Boss Mode / BlueprintLoops / Light Loop	Built‑in coordination patterns for delegating work to specialist sub‑agents, running loops that persist across restarts, or keeping a lightweight continuous workflow.
Browser integration	A session‑owned in‑app browser stays in context with the files and agents, so an agent can browse, scrape, or render a page without leaving the workspace.

Highlights from the README

Durable by default – Sessions are tied to a Scope and keep full history even when the LLM’s token window is trimmed.
One runtime, every surface – The same backend powers the Web workbench, a native Electron desktop client, a command‑line interface, and a server‑API/SDK.
First‑class agent coordination – Specialized sub‑agents, persistent Blueprint loops, and a “Boss Mode” tree of workers.
Local‑first & extensible – You add providers, tools, skills, MCP servers, plugins, channels, or remote Synergy‑Link targets while retaining full ownership of your data.
Benchmark claim – On the DeepSWE v1.1 benchmark (113 real repo‑engineering tasks) the synergy‑max agent using DeepSeek‑v4‑flash lifted Pass@1 from 53 % to 67.3 % at $0.54 per task, outperforming the official mini‑SWE‑agent baseline.

Quick start (from the README)

Desktop – Download the installer for macOS (.pkg), Windows (.exe), or Linux (.deb). The installer also registers a synergy CLI.

CLI / Web – One‑liner installer:

curl -fsSL https://raw.githubusercontent.com/SII-Holos/synergy/main/install | bash

Then run:

synergy config wizard   # pick a model provider
synergy start           # launch the local runtime
synergy web             # open the web workbench in a browser

One‑off task – Send a prompt directly from the terminal:
```
synergy send "summarize this repository"
```
Useful commands – synergy status, synergy logs, synergy doctor, synergy stop, synergy upgrade, synergy uninstall.
Browser tooling – Run synergy browser install to get the managed Chromium version required for in‑app browsing.

Typical use cases

Long‑running code‑generation projects – Keep generated files, test results, and agent notes together; resume after days.
Research notebooks – Agents write notes and store learned facts in the Library, which can be queried later.
Scheduled automation – Use the Agenda to run a code‑review bot every night or a data‑scraping agent weekly.
Tool‑augmented agents – Plug in custom CLI tools, IDE extensions, or external APIs as “Skills” that agents can call.
Team collaboration – Multiple users can connect the same Holos account, see each other’s presence, and share a Synergy Link to remote execution targets.

Development & extensibility (as described)

Monorepo – Built with Bun, TypeScript ESM modules. bun dev prepare sets up the repo.
Runtime – bun dev server starts the core service; bun dev app, bun dev web, bun dev desktop launch the respective front‑ends.
Testing – bun test in each package; bun run quality:quick enforces layout and runs quick checks.
Plugins – Scaffold with bunx @ericsanchezok/synergy-plugin-kit create my-plugin --template tool-ui, then build/validate with synergy-plugin commands.
SDK / API – A shared contract is exposed for first‑party clients and third‑party integrations.

Where to learn more

Website: https://synergy.holosai.io
Docs: docs/README.md (product overview, architecture, CLI reference, configuration, plugin guide, etc.)
Benchmarks: DeepSWE v1.1 results shown in the README.
Community: Issues, PRs, and contribution guidelines are in the repo; security reporting via .github/SECURITY.md.

TL;DR

Synergy is a locally hosted, multi‑surface workspace that makes AI‑agent work persistent and orchestratable. It bundles a runtime, a web/desktop UI, a CLI, and an extensible plugin system, letting you treat an LLM‑agent as a long‑lived developer assistant rather than a fleeting chat.