Skip to content
Get started
Developer tools · Available now

Your node.
Your agent.
One command.

A native workspace for signed data and peer-to-peer discovery. Ready for your terminal and the agents you already use.

npx joinweave

Node.js 20+ · macOS & Linux · Requirements

Start the quickstart
Your first session
npx joinweave

~/.weave/bin/weave doctor --json
~/.weave/bin/weave node status --json
~/.weave/bin/weave dht peers --json

The installer creates ~/.weave and ~/Weave, generates local keys and starts a background node. It asks before changing your shell or agent configuration.

Three ways to build

Use the tools.
Compose the stack.

Start with the published runtime. Reach for the library reference when building your own application.

Native CLI · 0.1.0

Operate your workspace.

Create and read strands, discover peers, announce data and replicate selected blocks. Inspect service health and machine-readable results.

CLI reference ↗MCP server · 0.1.0

Let your agent work.

Ten stdio tools expose the same native operations to Claude Desktop, Claude Code, Cursor and Codex. Private signing keys stay in your local store.

MCP setup and tool reference ↗SDK and library reference

Go beneath the CLI.

Explore the Rust node builder and the memory, storage, networking and coordination primitives. Each library has its own interfaces and implementation boundaries.

Explore the Rust SDK ↗

The npm release includes the installer, CLI launcher, MCP server and four native binary packages. A public @useweave/sdk package is not part of this release. The public distribution repository contains the JavaScript tooling and prebuilt executables; the native Rust implementation remains private.

A real peer-to-peer path

A signed strand.
Only the blocks you need.

Publish from one machine, pin the writer’s public key on another, and verify the data that arrives.

Share and verify.

A strand is an append-only record owned by a writer key. Discovery locates its provider; replication authenticates the writer and verifies selected blocks. Later reads can fetch missing blocks while cached reads use local data.

Follow the two-machine guide ↗

Verified in the release.

  • Fresh macOS and Linux installs with live peers.
  • Service stop, start, crash recovery and safe reruns.
  • Sparse replication between two machines.
  • Real Codex MCP discovery and replication calls.
Release evidence and limits ↗
Keep control

Local keys.
Explicit choices.

A workspace on your own machine, with clear requirements and recovery paths.

Install with confidence.

Node.js 20 or newer. macOS ARM64 and x64; Linux ARM64 and x64 with glibc 2.39 or newer. Linux ARM64 also needs OpenSSL 3. Managed Linux nodes use a systemd user session. Windows and musl builds are not included.

Unattended npx joinweave --yes --json leaves shell and agent settings alone unless explicitly requested. Uninstall retains identity and workspace data unless you choose --purge.

Operations and troubleshooting ↗

Identity across the ecosystem.

Weave creates a local Ed25519 identity. OpenAgentID provides a separate identity and authority toolkit for agents. Automatic registration, account linking and weave login are not included in joinweave 0.1.1.

The full documentation also covers thirteen primitives, Filament, AgentFS, Loom and clients such as dBrowser, with component-specific status and integration requirements.

Explore the complete stack ↗