agent-weave README

The project's README from github.com/bushm2092-del/agent-weave. As one markdown file: README.md.

AgentWeave

English | 简体中文

AgentWeave is a local-first, spatial workspace for running individual AI agents and coordinating multi-agent teams. It combines a visual canvas, durable conversations, role presets, team orchestration, and an Electron desktop shell in one pnpm monorepo.

AgentWeave is currently under active development. APIs and persisted data formats may change before the first stable release.

Product Preview

Spatial multi-agent canvas

Place agents from different providers on one infinite canvas, keep each conversation independent, and arrange the workspace around the task.

Multiple AI agents arranged on the AgentWeave canvas

Live agent conversations

Work with an agent directly inside a resizable canvas node, including model controls, streamed responses, reasoning, tool calls, and workspace context.

A live Pi agent conversation with tool-call output

Agent Team orchestration

Coordinate a leader and multiple teammates in one team node, while inspecting members, tasks, and activity from the team panel.

An Agent Team with four independently managed members

Reusable role presets

Create persisted roles with provider-specific instructions, then assign them consistently when building new agent teams.

The AgentWeave role preset library

Highlights

Architecture

Package Responsibility
packages/web React 19 application, tldraw canvas, conversation UI, and team management
packages/server Express API, SQLite persistence, SSE streams, acpx integration, and team orchestration
packages/contracts Shared Zod schemas, request/response DTOs, events, and domain types
packages/desktop Electron shell and macOS/Windows packaging

The server communicates with agent runtimes through acpx. Team agents also collaborate through an authenticated stdio MCP bridge. Each team member owns an isolated managed conversation while the Team service coordinates runs, tasks, mailbox intents, spawn approvals, and replayable events.

Requirements

Quick Start

Install dependencies and start the web application and API:

pnpm install
pnpm dev

The web application is available at http://localhost:5173 by default.

To start only one side:

pnpm dev:web
pnpm dev:server

To run the Electron application, including its development web and API servers:

pnpm dev:desktop

Configuration

Copy the server environment example before overriding defaults:

cp packages/server/.env.example packages/server/.env

The server configuration covers the host, port, allowed CORS origins, SQLite database path, acpx state directory, and turn timeout. Desktop production builds use the platform user-data directory by default. Set AGENT_WEAVE_API_ORIGIN before launching the desktop application to connect it to an external API server.

Desktop Builds

Create unpacked application output:

pnpm desktop:pack

Build distributable packages under packages/desktop/release:

pnpm desktop:dist:mac
pnpm desktop:dist:win

The macOS build produces DMG and ZIP artifacts for Intel and Apple Silicon. The Windows build produces an x64 NSIS installer and portable executable.

Main APIs

The API is mounted under /api/v1 and includes:

Conversation and Team event streams support sequence cursors for reconnecting clients. Live content deltas are delivered as transient SSE events, while completed run content is stored as full blocks for efficient reloads.

Roadmap

Quality Checks

Run all repository checks from the project root:

pnpm typecheck
pnpm lint
pnpm test
pnpm build

Documentation

Community

Scan the QR code to join the AgentWeave WeChat group for product updates, usage discussions, and feedback. The invitation QR code is refreshed periodically.

Join the AgentWeave WeChat group

License

No license has been declared yet. Until one is added, all rights are reserved by the repository owner.

agent-weave (bushm2092-del/agent-weave)

Searching Database…

205 ·GitHub
Agent-weave
What is this?AgentWeave is a local-first, spatial workspace for running individual AI agents and coordinating multi-agent teams on an infinite canvas, supporting providers like Codex, Claude, OpenCode, and Pi.
Is this a web app or a desktop app?Both: it's a React web application backed by an Express API, and the same web UI plus embedded API can also be packaged as an Electron desktop app for macOS and Windows.
How do I get it running?Clone the pnpm monorepo, install dependencies, then run pnpm dev to start the web app and API together (or pnpm dev:web / pnpm dev:server for one side, pnpm dev:desktop for the Electron shell).
What do I need installed before running it?You need Node.js 24 or later, pnpm 11 (pinned via packageManager), and an agent provider that your local acpx installation supports.
Is this ready for everyday production use?Not yet — the project is explicitly under active development, and the README warns that APIs and persisted data formats may still change before the first stable release.
Where does my conversation data end up?Conversations, content blocks, runs, canvas snapshots, and team state are all persisted locally in SQLite rather than sent to a remote service.
What is acpx and how do agents connect through it?acpx is the runtime the AgentWeave server talks to in order to drive each agent provider; team agents additionally collaborate through an authenticated stdio MCP bridge.
How do Agent Teams actually work?A team node has one leader and multiple teammates, each with an isolated conversation, shared workspace context, tasks, and mailbox messages, with approval-controlled spawning of new members.
Can agents remember things across sessions?A shared memory foundation captures reusable knowledge from completed agent work so other agents and future sessions can recall prior decisions and discoveries instead of repeating research.
What are similar projects?multi-agent-discuss, Agentlas-OS, munder-difflin, ruflo, evenfire, CanvasTTY, turnstone, codify
Which topics is it in?sse, electron-app, express, multi-agent-systems, canvas, agent-memory, monorepo, orchestration, agent-orchestration, electron, sqlite, multi-agent
Creator
bushm2092-del
Size
5.8 MB
Stars
205
Updated
CommitSep 03
Age
1mo
Commits · 90 Days