xMesh

xMesh generates your organization's decisions and cognition — the operating system of the agentic-native organization. The cognition control plane for an agentic mesh: one desktop process (API + web cockpit) plus the xMesh iOS app. It watches cognition — what each agent admitted, why, and the lineage behind every claim — not agents and messages. Built on the open Mesh Memory Protocol and the @sym-bot substrate.

Run

npm i -g @sym-bot/xmesh
xmesh

On first run it generates a passcode, prints it, and stores it in ~/.xmesh/passcode. It announces itself on your Wi-Fi (_xmesh._tcp), so the iOS app finds it without a typed IP — open the app, tap your mesh, enter the passcode. The web cockpit is on http://localhost:8787.

| Env | Default | Meaning | | --- | --- | --- | | XMESH_PORT | 8787 | API + web cockpit port | | XMESH_PASSCODE | generated on first run | overrides the stored passcode | | XMESH_AGENT_MODEL | claude-haiku-4-5 | model for deployed llm-mind agents | | XMESH_AGENT_TOKEN_BUDGET | 50000 | per-agent LLM token budget |

No API keys. Agents that use an LLM — deployed llm-mind agents and the mission workers — drive your own local CLI login: install Claude Code and/or the Codex CLI and log in, and xMesh runs claude -p / codex exec on your existing subscription. A gpt/codex model routes to Codex, anything else to Claude. Cost is never implicit — the default rule-mind agents need no LLM at all, and an llm agent won't deploy unless a CLI is present.

State lives under ~/.xmesh/ (sessions, passcode, deployed-agent roster) and the mesh's own stores under ~/.sym/ — xMesh reads what nodes persist and sign; it holds no shared store and routes no messages (observe-only invariant).

Licensing

Solo mode is free and complete: one operator, the full local product — first mission, cognition-node deploy, missions, Canon, the cockpit and the iOS app on your LAN. The org tier is licensed per organization and unlocks the surfaces where a decision binds more than one human: additional operators (seat-capped), and the cross-org gateway. Licenses are offline-verifiable signed tokens — no phone-home, no activation server; paste yours into ~/.xmesh/license (or XMESH_LICENSE) and it takes effect on the next request. Get one at xmesh.bot.

Learn it

Deploy a mesh from scratch in ten minutes, watch cognition form, steer with directives agents are free to reject, read the issue queue, ask the mesh, and put Claude Code on it. Every recipe is backed by this repository's executable BDD suite (test/, and the iOS ten-minute-mesh XCUITests).

Develop

npm run dev     # API (tsx) + web (vite), hot reload
npm test        # server suite — no paid APIs, ever
npm run build   # compile server → dist/ and web → web/dist (what ships)