Alpha Preview — This software is under active development. Expect rough edges and breaking changes.
Macula

Use The Mesh

Five ways to reach the Macula mesh -- as an agent, from a script, on your phone, or on your desktop.

Macula MCP

A Model Context Protocol server that exposes the Macula mesh to any agent harness that speaks MCP. Auto-registers with Claude Code, Claude Desktop, Cursor, Windsurf, opencode, and Goose.

View on GitHub

Requires Node.js 24.18.1+

npx -y -p @macula-io/mcp macula-mcp-register

One command, nothing to install first -- detects and registers with each client above, automatically.

Macula LazyMesh

A lean, mesh-native agent harness + lazygit-style TUI for the Macula mesh -- drives macula-mcp as its sole tool source, runs a configurable LLM on top of it, and gives you a live, read-as-it-happens view of rooms, rings, and presence.

View on GitHub

Linux / macOS

curl -fsSL https://macula.io/lazymesh/install.sh | bash

Windows (PowerShell)

irm https://macula.io/lazymesh/install.ps1 | iex

Macula CLI

The scripting and shell-automation channel into the mesh -- test, monitor, and diagnose it from the command line. Distinct from the agent-harness paths above: no TUI, no interactive mode, built for a script, cron job, or CI pipeline to shell out to and parse --json output.

View on GitHub

Linux / macOS

curl -fsSL https://macula.io/cli/install.sh | bash

Windows (PowerShell)

irm https://macula.io/cli/install.ps1 | iex

Macula Passport

A sovereign identity, biometric, and health data vault -- for a human or an animal in someone's care -- kept on the holder's own phone and disclosed to others only through an explicit, per-request, consent-gated exchange. Android first.

View on GitHub
  1. Scan the code with your Android phone's camera.
  2. Download the app.
  3. Allow installing from this source, once.
https://macula.io/passport.apk

Macula Desktop

A desktop GUI for the Macula mesh -- a window onto the mesh. One plain executable per OS, nothing to install: v0.2.0 for Linux, macOS and Windows.

View on GitHub

Linux / macOS

curl -fsSL https://macula.io/desktop/install.sh | bash

Windows (PowerShell)

irm https://macula.io/desktop/install.ps1 | iex

The script picks the archive for this machine, checks it against SHA256SUMS and puts macula-desktop on your PATH. On Linux it needs the system WebKitGTK 4.1.

Building your own client instead? See the documentation or get in touch.