Starweft

Distributed Multi-Agent Coordination

Orchestrate AI Agents Across Machines

Starweft is a P2P CLI that coordinates principal, owner, worker, and relay nodes to decompose visions into tasks and execute them with OpenClaw-powered AI agents.

Get Started View on GitHub

Architecture

Four Roles, Zero Servers

Principal

Submits visions (goals) and issues stop commands to the network.

Owner

Decomposes visions into tasks and distributes them to available workers.

Worker

Executes tasks via the OpenClaw bridge and reports progress and results.

Relay

Forwards messages between nodes that cannot communicate directly.

Features

Built for Distributed Agent Coordination

Peer-to-Peer Architecture

No central server. All nodes communicate directly via libp2p or local mailbox transport.

Ed25519 Signing

Every message is cryptographically signed with Ed25519. Canonical JSON ensures deterministic verification.

Multi-Agent Task Coordination

Principal, Owner, Worker, and Relay roles collaborate to decompose visions into executable tasks.

OpenClaw Integration

Workers execute tasks via OpenClaw bridge, enabling autonomous AI agent execution with progress reporting.

SQLite Event Sourcing

All events are persisted to a local SQLite database with WAL mode for reliable, append-only storage.

Cross-Platform

Runs on Linux, macOS, and Windows with platform-aware defaults for transport and data directories.

Task Lifecycle Management

Full lifecycle from vision submission through planning, assignment, execution, evaluation, and completion.

Zero Infrastructure Cost

Everything runs on your local machine. No cloud services, no databases to manage, no monthly bills.

Installation

One Command to Install

$cargo install starweft

Quick Start

Up and Running in Minutes

#Initialize nodes

$starweft init --role principal --data-dir ./demo/principal

$starweft init --role owner --data-dir ./demo/owner

$starweft init --role worker --data-dir ./demo/worker

#Create identities

$starweft identity create --data-dir ./demo/principal

$starweft identity create --data-dir ./demo/owner

$starweft identity create --data-dir ./demo/worker

#Register peers and start nodes

$starweft peer add /unix/./demo/owner/mailbox.sock --data-dir ./demo/principal \

--actor-id <OWNER_ID> --node-id <NODE_ID> --public-key <PUB_KEY>

#Run nodes in separate terminals

$starweft run --data-dir ./demo/principal

$starweft run --data-dir ./demo/owner

$starweft run --data-dir ./demo/worker

#Submit a vision

$starweft vision submit "Build a REST API with Rust" --data-dir ./demo/principal

FAQ

Frequently Asked Questions

What is Starweft?

Starweft is a distributed multi-agent task coordination CLI built in Rust. It enables multiple AI agents to collaborate on complex tasks using a P2P architecture.

Do I need a server?

No. Starweft is fully peer-to-peer. Nodes communicate via local Unix sockets or libp2p TCP. There is no central server.

What is OpenClaw?

OpenClaw is an autonomous AI agent execution framework. Starweft workers use OpenClaw to execute tasks by spawning it as a subprocess.

What platforms are supported?

Linux (x86_64), macOS (x86_64, aarch64), and Windows (x86_64). The Rust toolchain handles cross-compilation.

Is Starweft free?

Yes. Starweft is open source under the MIT license. The only cost is the LLM API usage from OpenClaw, which is not a Starweft expense.

How do nodes discover each other?

Nodes are manually registered as peers using the `starweft peer add` command with their multiaddr, actor ID, node ID, and public key.