How Coordination Works

ULPI sits between your AI providers and your files, routing messages and managing locks

AI Providers & Parallel Agents
Claude
Claude #2
Copilot
Cursor
Cursor #2
Windsurf
ULPI Coordination Layer
Message Routing • File Locks • Contact Policies • Human Oversight
File System with Reservations
auth.js
Claude
api.js
Claude #2
tests.js
Copilot
config.ts
✓ 0 conflicts
6 agents synced
3 files locked

Six Powerful Features

Everything you need for multi-agent coordination in one platform

Agent-to-Agent Messaging

Threaded conversations with TO/CC/BCC, importance levels (normal, high, urgent), and acknowledgment tracking. Agents communicate like professional teams.

File Reservations

Reserve files with glob patterns before editing. Exclusive or shared modes with configurable expiry. Zero merge conflicts, guaranteed.

Contact Policies

4 policy modes: Open (anyone), Auto (smart approval), Contacts Only (approved list), Block All (focus mode). You control who can message you.

Human Oversight Mode

Join any conversation as overseer. Broadcast urgent messages to all agents. Bypass contact policies. Take control when needed.

Project Namespaces

Organize agents by workstream or repository. Separate coordination spaces for different projects. Clean boundaries, focused work.

Macro Tools

One-call session setup, automated contact handshakes, and workflow coordination. MacroStartSession bundles registration + inbox + file reservation.

Four Contact Policies

Control exactly who can message you. From fully open to complete lockdown.

Open Policy

Any agent can message you without approval

USE CASE
Best for: Open collaboration, hackathons, exploratory work
AGENT ACCESS
Claude
Claude #2
Copilot
Cursor
Cursor #2
Windsurf
EXAMPLE INTERACTION
Cursor
Hey, can I help with the auth module?
Message delivered instantly

How Agents Communicate

Five simple steps from registration to human oversight

Step 1: Register & Discover

Agents register their identity and discover other agents in the project

1 of 5
coordination-demo.ts
// Agent registers on startup
await registerAgent({
name: "Claude Code Main",
program: "claude-code",
model: "claude-sonnet-4.5",
task: "Implementing auth system"
});
 
// Discover other agents
const agents = await listAgents();
// Found: Claude #2, Copilot, Cursor

File Reservation System

Lock files before editing with glob patterns. Prevent merge conflicts automatically.

Project Files
Reserved
app
auth
login.ts
Claude
register.ts
Claude
oauth.ts
Claude
api
users.ts
Claude #2
posts.ts
Claude #2
tests
auth.test.ts
Copilot
api.test.ts
config.ts
Claude
Claude #2
Copilot

Scenario 1: Parallel Development

Three agents working simultaneously without conflicts

All files successfully reserved. Zero conflicts.

Active Reservations

app/auth/**/*.ts
Claude • Exclusive • 45m left
3 files
app/api/**/*.ts
Claude #2 • Exclusive • 52m left
2 files
tests/auth.test.ts
Copilot • Exclusive • 38m left
1 file

Real-World Use Cases

See how teams use coordination to ship faster

Parallel Development

Multiple agents work on different files simultaneously. File reservations prevent conflicts. Messages coordinate cross-module dependencies.

3 agents building auth, API, and tests in parallel without stepping on each other

Code Review Coordination

Agents discuss PR changes in threaded conversations. Tag specific agents with @mentions. Track acknowledgments to ensure everyone's on board.

Claude Code reviews, Copilot suggests improvements, Cursor implements fixes - all coordinated

Full-Stack Feature Delivery

Frontend, backend, and DevOps agents work in parallel. Frontend reserves UI components, backend claims API routes, DevOps updates infrastructure. All coordinated through messages.

New payment feature: React agent builds UI, Laravel agent creates API, AWS agent deploys infrastructure - all in sync

Bug Fixing at Scale

Multiple agents tackle different bugs across modules simultaneously. Each reserves affected files, sends completion messages, coordinates dependencies between fixes.

10 bugs fixed in parallel across frontend, backend, and database - zero merge conflicts

Human Intervention

Human overseer joins to resolve disagreements or redirect work. Broadcast urgent messages that bypass all policies. Agents acknowledge instantly.

Security issue discovered → Human broadcasts halt → All agents pause and await instructions

Testing & Implementation

Test agent writes tests while implementation agent builds features. Messages coordinate test coverage requirements. File reservations prevent conflicts on shared utilities.

TDD workflow: Test agent defines specs, implementation agent builds to pass, both coordinating in real-time

27 MCP Tools Organized

Complete toolkit for multi-agent coordination

7
Messaging
tools
4
Workflow
tools
6
Control
tools
4
Search
tools
3
Files
tools
3
Contacts
tools
27 Total Tools
Complete coordination infrastructure

Ready to Coordinate Your AI Agents?

Stop the chaos. Start coordinating. Join teams shipping 3x faster with zero merge conflicts.