distributed-mesh

Organize distributed squad state across machines using git as transport.

2|1|Updated Mar 25, 2026
One-click install
npx skills add https://github.com/PlagueHO/plagueho.learn --skill distributed-mesh-plagueho
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: distributed-mesh
Source: https://github.com/PlagueHO/plagueho.learn/tree/main/.copilot/skills/distributed-mesh
Command: npx skills add https://github.com/PlagueHO/plagueho.learn --skill distributed-mesh-plagueho

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, git, curl.

What problem does it solve?

Centralizes the coordination of distributed squads across multiple machines by treating git as the transport mesh, enabling consistent state sharing without a centralized runtime.

Core Features & Use Cases

  • Generates a mesh.json configuration from user-provided topology for squads, zones, and synchronization targets.
  • Copies bundled sync-mesh.sh and sync-mesh.ps1 into the project root to materialize remote state deterministically.
  • Initializes a Zone 2 shared-state repo when applicable and records decisions in a mesh inbox.

Quick Start

Answer the topology questions and run the bundled sync script to materialize remote state.

Frequently Asked Questions about distributed-mesh

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I synchronize squad state across multiple machines without a centralized server?

Git mesh synchronization enables distributed squad coordination by treating git as the transport layer. It generates a mesh.json configuration and bundled sync scripts to share state deterministically across Zone 1 local paths, Zone 2 remote-trusted repos, and Zone 3 remote-opaque contracts.

What is a git mesh and how does it coordinate distributed squads?

A git mesh coordinates distributed squads by using git as the transport layer to share state. It organizes machine topology into three zones: local paths, remote-trusted git-backed repos, and remote-opaque published contracts, producing a mesh.json configuration for deterministic state synchronization.

Do I need to install jq and curl to use git for distributed state synchronization?

Yes, you need jq, git, and curl installed to execute the bundled sync-mesh.sh and sync-mesh.ps1 scripts. These dependencies are required to parse the mesh.json configuration and interact with remote git repositories during the state synchronization process.

How do I set up a mesh.json file for multi-machine squad coordination?

You set up mesh.json for multi-machine squad coordination by answering topology questions during initialization. This generates the configuration file defining your squads, zones, and synchronization targets, copies the sync-mesh scripts to the project root, and records a decision entry in the .squad/decisions inbox.

Can I initialize a shared-state git repo for remote squad synchronization?

Yes, you can initialize a Zone 2 shared-state git repo for remote squad synchronization. The initialization workflow optionally sets up this remote-trusted git-backed repository to materialize remote state deterministically and records the setup decision in a mesh inbox.

What are the limitations of using a git transport mesh for squad state synchronization?

A limitation of using a git transport mesh for state synchronization is that it requires specific dependencies like jq and curl, and relies on a deterministic workflow. It is designed for specific zone topologies and may not suit scenarios needing real-time centralized state updates.