Local-first MCP coordination

HALL MCP turns multi-agent chaos into a dependable dev team.

HALL (Holistic Agent Live Lobby) is the coordination layer that keeps every agent honest and in sync. Declare intent, claim files, attach evidence, and stream realtime signals without phoning home.

Download HALL MCP Get started Read docs

Works with Claude Code, Cursor, Continue MIT licensed | Local-first

5 Core signals

0 Phone home

1 Shared reality

Start here

From zero to coordinated in under 3 minutes.

Install HALL locally, point your agents at the MCP server, and watch intent, claims, and receipts appear in one shared lobby.

Clone the repo Download ZIP

Node 20+ required Runs on 127.0.0.1 by default

Install and run

npm install
npm run dev

Build MCP server

npm run build
npm run mcp

Connect your tool

Add HALL MCP to Claude Code, Cursor, or Continue in minutes.

IDE setup guide

Local endpoints

API: http://localhost:4177/api

WebSocket: ws://localhost:4177/ws

Dashboard: http://localhost:5174

Dashboard requires cd frontend && npm install && npm run dev

Quick CLI

npm run build
npm run cli -- status
npm run cli -- task create --title "First task"

The coordination surface

Every agent gets the same truth, in realtime.

HALL MCP is not another dashboard. It is the protocol level source of truth that keeps intent, ownership, and evidence from drifting apart.

Intent announcements

Declare what you plan to change before edits happen. HALL records it and broadcasts the signal.

File claims

Short-lived file ownership prevents collisions. No more surprise merges at 2AM.

Overlap detection

Catch conflicts before they explode. Agents know who is touching what in real time.

Evidence receipts

Attach command output as proof. If it is not evidenced, it did not happen.

Realtime events

Stream updates to every connected tool with WebSocket events and a single source of truth.

Local-first trust

HALL never phones home. It runs where your repo lives and never edits without consent.

MCP built in

Plug HALL into any MCP client in minutes.

HALL exposes its coordination layer as MCP tools so Claude Code, Cursor, Continue, and any MCP client can share intent and receipts instantly.

hall_task_create, hall_intent_post, hall_claim
hall_evidence_attach and claim release gating
stdio transport and JSON-RPC 2.0 compliance

MCP docs Browse repo

MCP config

npm install
npm run build
npm run mcp

# MCP config example
{
  "mcpServers": {
    "hall": {
      "command": "node",
      "args": ["/absolute/path/to/hall/dist/mcp.js"],
      "env": { "HALL_DB_PATH": "/path/to/.hall/hall.sqlite" }
    }
  }
}

A tighter loop

From intent to evidence in a single flow.

HALL enforces a workflow that prevents silent failures and forces clarity across every agent.

Post intent

Declare scope and acceptance criteria before edits begin.

Claim files

Hold short-lived ownership while you work.

Attach evidence

Capture command output and receipts for every change.

Release clean

Unlock claims only after evidence is attached.

Ops ready

Every change leaves a trail.

Operations should not guess what happened at 3AM. HALL keeps a live ledger of tasks, intents, claims, and evidence.

Detect

Check /api/status and the event stream for drift.

Recover

Roll back by restoring the last known good build.

Audit

Inspect evidence receipts before you merge.

No surprises policy

HALL never auto-edits your repo, never phones home, and logs what it is doing and why. Anything destructive is behind an explicit command.

Security posture

Ship with evidence

Bring your agents into one shared room.

HALL MCP keeps the lights on for every agent, every task, every deploy. It is the coordination layer your team assumes already exists.

Download GitHub repo