Docs · v0.20.0

Sixty seconds to a fleet

Meshfleet is an MCP server for OpenCode. It runs entirely on your machine, spawns agents as real OS processes, and gives them peer-to-peer messaging with witnessed receipts. The complete reference lives in the GitHub README; this page is the fast path.

1 · Install

npm install -g meshfleet

Or skip the global install and let OpenCode run it with npx (step 2 does this).

2 · Register with OpenCode

Add the server to your opencode.json:

{
  "mcp": {
    "agent-mesh": {
      "type": "local",
      "command": ["npx", "meshfleet"]
    }
  }
}

3 · Spawn your first fleet

Restart OpenCode and ask for parallel work in plain language:

> spawn a fleet of three agents: a researcher, a coder,
  and a reviewer. Research issue #142, fix it, and
  review the fix. Hand off between stages.

Agents spawn as separate OS processes (no 30-minute timeout), pass work with handoff, ask each other questions, and report results. Every delivery is witnessed — get_receipts reads the trail; verify_ledger audits unsigned integrity. Ask for get_receipts to see the ledger.

The toolbox (36 tools)

fleet lifecyclespawn_fleet · spawn_from_template · attach_agent · fleet_status · list_fleets · set_fleet_timeout · list_fleet_templates · save_fleet_template

messagingsend_message · send_messages · get_inbox · ack_message · subscribe_inbox

coordinationroute_work · register_capability · list_agents · record_routing_outcome

advisory routingcompile_route_candidates · recommend_route · plan_speculative_backlog

discussionsask_peer · wake_agent · reply_discussion · get_discussion

the recordreceipt · get_receipts · verify_ledger · verify_ledger_v2 · verify_ledger_v3 · collect_results

governanceopen_ratification · cast_vote · tally_ratification · sweep_ratifications

healthping · get_health

Good to know

Local and quiet. No accounts, no telemetry, no network calls except the models you already use.
Host-free path. agent-mesh demo (60s, ends with a real verify) · agent-mesh doctor (six-check install diagnosis) · inspect --verify <file> audits a copy, never the evidence · --explain / --json for triage and CI.
Nested-safe. Spawned agents load your MCP config too; Meshfleet marks children with AGENT_MESH_CHILD=1 so nested instances stay passive instead of fighting over the ledger.
1,475 tests on main plus a process-topology gate (validate-gates) that spawns real child fleets before every release.
Stuck? Open an issue on GitHub or email support@meshfleet.app. Early users get embarrassingly fast replies.