Features
Product
EnvoyGo Mobile Knowledge Base Family Network Agent Network Envoy Harness Coding EnvoyDev Envoy Market Architecture Security Download
ไธญๆ–‡ Read Guidebook View on GitHub

Decentralized P2P Agentic Mesh

A distributed social network, agent network, and knowledge sharing system. Chat peer-to-peer, use Coding on your home node with ready agents (Envoy Harness, Claude Code, Codex, Cursor, โ€ฆ), run AI agents locally with OpenClaw, connect external agents, delegate Team jobs across bonded contacts, and turn your home computer into a private family network โ€” accessible from anywhere via EnvoyGo.

Download View on GitHub
Open Source
MIT License
Mac/Linux/Windows
EnvoyMesh Desktop
iOS/Android
EnvoyGo Mobile

System Architecture

A decentralized mesh where every node is a fully-capable peer.

EnvoyMesh Network Primary Envoy Desktop / Home Server Diplomat Network / libp2p Identity / Bonds Trust Policy Workflows OpenClaw Agent Vault API Knowledge Retrieval Sandboxed Brain Local LLM / AI Audit Log EnvoyGo Mobile App Identity Ed25519 Keys Chat UI P2P Messaging Terminal Remote Access Agents Agent Control Friend Envoy Remote Peer Diplomat Network Bonds Trust Policy Workflows AI Agent Vault Knowledge Brain LLM / AI Audit Log External Agents HomeClaw Hermes OpenHuman Obsidian Signed Envelopes Chat / Media Knowledge Sync Agent API Vault Import

Core Features

Everything you need for secure, private communication and AI-powered workflows. Click any screenshot to view full size.

P2P chat on EnvoyMesh desktop
๐Ÿ’ฌ

P2P Social Communication

Direct chat, group chat, voice messages, and WebRTC audio/video calls. All peer-to-peer โ€” no third-party servers, no cloud middlemen.

EnvoyAI built-in agent
๐Ÿค–

Built-in EnvoyAI Agent

Run OpenClaw, the built-in AI agent, on your local machine. Extend its skills directly through EnvoyMesh and automate your workflows โ€” no public IP required.

External agent
๐Ÿ”—

Ext Agent

Connect with external agents through EnvoyMesh. Access HomeClaw, Hermes, OpenHuman, and other AI agents in one unified interface:

Agent network
๐ŸŒ

Agent Network

Run Team jobs across opted-in agents on bonded contacts. Your home agent plans multi-step work, workers execute on their own nodes, and you review the plan, budget, and final report โ€” with optional parallel speculation when enabled.

Envoy Harness in Social
๐Ÿ› ๏ธ

Envoy Harness

Coding agent on your home node โ€” see tool activity, approve risky steps, review diffs, and recover after disconnects. Same semantic timeline in Chat and Terminal. Beta

Peer discovery
๐Ÿ”

Peer Discovery

Find and bond with peers on your local network or across the internet via relay. Manage trust tiers โ€” from public strangers to direct friends.

Content feed
๐Ÿ“ฐ

Content Feed

A social feed of posts, updates, and shared content from your bonded contacts. Browse, like, and comment โ€” all delivered peer-to-peer.

Blog publishing
โœ๏ธ

Blog Publishing

Publish long-form blog posts with a rich editor. Your content lives on your node and syncs to bonded peers โ€” no centralized platform required.

Explore bazaar
๐Ÿ›๏ธ

Explore

Discover people and public content metadata across the mesh โ€” authors, topics, and pages before any bytes transfer. Pair with the Market tab for listings and shops.

Terminal access
โŒจ๏ธ

Terminal Access

Open a full shell to your home machine from the desktop app or remotely from EnvoyGo. Run commands, manage files, and control your node.

Pi coding agent
๐Ÿฅง

Pi Coding Agent

Connect to remote devices like a Raspberry Pi. Run a coding agent that can edit files, execute programs, and develop software on remote hardware.

Settings
โš™๏ธ

Node Settings

Configure your node, manage model providers, set up relay connections, and control security policies. Full control over your mesh infrastructure.

Agent Network

Team jobs โ€” multi-agent collaboration on LAN or WAN among bonded contacts who opt in. Plan, delegate, track, and collect attributed reports.

๐ŸŒ LAN / WAN Mesh ๐Ÿ  Home Node Team Jobs ยท Orchestrator โ–ถ Job A in progress ยท EnvoyAI โœ“ Job B completed ยท HomeClaw โณ Job C queued ยท Hermes create ยท assign ยท track ยท collect delegate progress ยท results EnvoyAI built-in local HomeClaw external WAN Hermes external LAN OpenHuman external WAN

Plan ยท delegate to bonded workers ยท track ยท collect report

Team jobs let your home agent plan multi-step work and delegate to opted-in agents on bonded contacts โ€” EnvoyAI, HomeClaw, Hermes, or OpenHuman. You review the plan, budget, and final report. Workers run on their own nodes; results stream back with attribution. Optional speculation can try parallel approaches on a step when enabled in chain defaults.

Beta ยท Desktop Social + Terminal

Envoy Harness

Coding agent on your home node โ€” see what the agent is doing, approve risky steps, review diffs, and recover from disconnects. One semantic timeline in Chat and Terminal.

  • Conversation-first timeline: messages, tool activity, approvals, file changes, completion
  • Safe by default: permission dock shows scope and risk before tools run
  • Runs on your hardware: local-first; optional peer execution with attribution
  • EnvoyGo: monitor, approve, and redirect from your phone โ€” not a full IDE
Envoy Harness coding agent in Social
Available ยท Coding in Social (0.6.0)

Coding

Projects and tasks on your home computer. Pick a ready agent โ€” Envoy Harness, Pi, Claude Code, Codex, Cursor, and more โ€” then chat, approve tools, and review changes in one place. Install and check other agents in Settings.

  • Project defaults for new tasks; each task can keep its own agent
  • Only ready agents appear when you start work; Settings lists every tool for install
  • Schedules and heartbeats to wake or start tasks on a timer
  • EnvoyGo: follow and approve from your phone
Coding in Social โ€” projects, tasks, and coding agents
Sister product

Want a dedicated coding desktop?

EnvoyDev is the control plane for coding agents โ€” project rail, task tree, and inline approvals in its own window. It pairs with the same home node as EnvoyMesh.

EnvoyDev โ†’
Available ยท Social + EnvoyGo

Envoy Market

Run a shop on your home node. Publish listings to bonded contacts or the public mesh. Search, shortlist with EnvoyAI, and chat sellers โ€” no central marketplace server.

  • My Shop โ€” listings with photos, price, category; public or bonds-only visibility
  • Browse & search โ€” aggregated cards from bonded shops and mesh strangers
  • Listing-scoped inquire โ€” chat before you bond; optional friendship afterward
  • Honest commerce โ€” reserved/sold soft close; no in-app payment in 0.4.0 โ€” settle off-mesh
Social Market and Discover tabs

Family Network

Your home computer, your family's private server โ€” turn one EnvoyMesh home node into a private family social network. Each member pairs their phone, gets their own profile, chats with everyone, and talks to AI. No cloud, no subscription.

๐Ÿ‘‘

Owner โ€” Full Power

Everything EnvoyMesh offers: AI, bots, Ext Agent, terminal, Pi, vault, mesh contacts, node settings, and family admin.

๐Ÿ‘จโ€๐Ÿ‘ฉโ€๐Ÿ‘ง

Family Members โ€” Focused & Private

Their own profile, their own AI threads, character bots, Ext Agent chat, and family direct + group chat. Push notifications included. No terminal, vault, or mesh settings.

Like Netflix profiles on one account โ€” each person gets an isolated experience on a shared home node. Complete data isolation between members.

Family Network on EnvoyMesh
๐Ÿ  Home Node ยท Owner Desktop Computer ๐Ÿค– Shared AI Agents EnvoyAI + Ext Agents serves all members Pairs via QR ๐Ÿ“ฑ Member A EnvoyGo ยท own profile Chats ยท AI threads ๐Ÿ”’ Private data isolated from others ๐Ÿ“ฑ Member B EnvoyGo ยท own profile Chats ยท AI threads ๐Ÿ”’ Private data isolated from others ๐Ÿ“ฑ Member C EnvoyGo ยท own profile Chats ยท AI threads ๐Ÿ”’ Private data isolated from others

One home node ยท multiple paired phones ยท shared AI agents ยท isolated data per member

Knowledge base and vault

Knowledge Base & Vault

EnvoyMesh includes a powerful local-first knowledge base with RAG indexing. Your documents, notes, and files are indexed for semantic search and injected into AI prompts as context. Public knowledge is shared across the mesh โ€” private data never leaves your node.

  • Import any file type โ€” Markdown, PDF, Word, images, and more
  • RAG indexing with vector + lexical + hybrid search modes
  • Envoy Local embeddings on your home node โ€” default Qwen sidecar, no cloud API key required
  • Self-healing reindex: recovers from oversized chunks and embed sidecar wedges automatically
  • Per-item sensitivity labels: public, friends, or private
  • Public items are queryable by all EnvoyMesh peers via knowledge.query
  • Agent context: vault snippets automatically injected into LLM prompts
๐ŸŒ
Public Shared with all mesh peers
๐Ÿ‘ฅ
Friends Bonded contacts only
๐Ÿ”’
Private Owner & agent only

๐Ÿ”Œ Plugin Architecture โ€” Bring Your Own Knowledge Base

EnvoyMesh designed a knowledge base plugin system. The built-in vault always works standalone, but plugins can enrich it with extra capabilities. The first plugin available is Obsidian โ€” open the same vault directory in Obsidian and get wiki-links, backlinks, graph view, tags, templates, frontmatter, and daily notes, all synced with your EnvoyMesh knowledge base.

EnvoyMesh Vault Core Local-first file store ยท RAG indexing ยท Sensitivity labels ยท Mesh sharing ยท Always runs
๐Ÿ”ฎ
Obsidian Wiki-links ยท Backlinks ยท Graph ยท Tags ยท Frontmatter Available
๐Ÿ“
Notion External KB via API Planned
๐Ÿ”Œ
MCP Server External KB via MCP protocol Planned
๐Ÿ”ฎ Get Obsidian ๐Ÿ“– Read the Docs

How It Works

EnvoyMesh follows a layered security architecture โ€” each component has a clear boundary and responsibility.

๐ŸŒ

Diplomat (Network)

libp2p connections, message parsing, rate limiting

๐Ÿ”‘

Identity & Bonds

Signature verification, trust tiers, policy enforcement

โš™๏ธ

Workflows & Agent Core

Task execution, AI routing, workflow management

๐Ÿ“ฆ

Vault API

Knowledge retrieval, document indexing, secure storage

๐Ÿง 

Sandboxed Brain

Local/remote model execution, semantic firewall

Security Pipeline

Every message goes through four checks before delivery:

  1. 1 Is it really from you? (signed with your Ed25519 key)
  2. 2 Do I trust you? (trust tiers: blocked, public, referred, direct)
  3. 3 Is this message allowed? (policy engine โ€” what can this sender do?)
  4. 4 Has it been seen before? (no replays, no duplicates)

Security by Design

Built with security as the first priority, not an afterthought.

๐Ÿ”‘

Self-Sovereign Identity

No central account database. Your keys, your identity.

๐Ÿ›ก๏ธ

Policy-Based Trust

Granular trust tiers and per-document permissions.

๐Ÿ“

End-to-End Audit

Every operation logged with correlation IDs.

๐Ÿ”’

Semantic Firewall

Pre-model filtering prevents prompt injection.

๐Ÿšซ

Deny-by-Default

Only approved data and capabilities accessible.

๐Ÿ”„

Key Rotation

Support for revocation and key rotation.

Download EnvoyMesh

Install the desktop node to run your private mesh, or the EnvoyGo app to access it from your phone.

EnvoyMesh for macOS

Apple Silicon ยท ARM 64 ยท DMG installer
Download DMG GitHub Download DMG Mirror

EnvoyMesh for Windows

Desktop node ยท EXE installer
Download EXE GitHub Download EXE Mirror

EnvoyGo for Android

Mobile thin client ยท Google Play & APK
Google Play Official Download APK GitHub Download APK Mirror
Scan QR code to download EnvoyGo on Google Play
Scan ยท Google Play

EnvoyGo for iOS

Mobile thin client ยท App Store
App Store Official
iOS 18.6+ ยท home node required
Scan QR code to download EnvoyGo on the App Store
Scan ยท App Store

EnvoyGo is on Google Play and the App Store โ€” scan a QR code or tap a button below. Linux users can build from source. GitHub links open the releases page โ€” pick your platform's asset. Can't download from GitHub? Use the Mirror link as a fallback.

Build from Source

Clone EnvoyMesh and run setup. Setup auto-clones/builds sibling envoy-harness when missing (needs Node.js, npm, pnpm). End users can skip this and use the downloads above.

git clone https://github.com/allenpeng0705/EnvoyMesh.git
cd EnvoyMesh
./scripts/setup.sh

# Run
npm run node:dev # Start the P2P node
npm run social:dev # Open http://localhost:5173
View on GitHub envoy-harness Read Guidebook