Relay App Icon
Local-First Flight Control Tower

Command your agents.
Protect your code.

Relay is a native macOS coordination and supervision hub for developers collaborating with AI coding agents (Claude Code, Cursor, Windsurf). Supervised autonomy, review-gated proposals, stdio MCP protocol, and 100% on-device storage.

Explore Architecture
Requires macOS 11.0 (Big Sur) or later • Apple Silicon & Intel Universal • Bundle ID: com.echosystems.relay • One-Time Purchase
Relay — Flight Control Tower (Interactive Simulation)
● Flight Tower Online · LocalHost :4747 Active

Supervised Review Queue 2 Pending

Supervised Autonomy: Agents propose, human approves
Windsurf • Core Engine Component
Proposal #104 · 2 mins ago
Checklist Toggle: “Implement 3-Way JSON Merge Engine”

Agent rationale: “Completed unit tests in storage.rs with 100% pass rate. Proposing to mark item as done and append confirmation log.”

- [ ] Implement 3-Way JSON Merge Engine (merge_json) + [x] Implement 3-Way JSON Merge Engine (merge_json) [Verified by Windsurf]
Claude Code • Architecture ADR Component
Proposal #105 · 4 mins ago
New Decision Block: “Enforce Kernel Advisory Locks via fs2”

Agent rationale: “To prevent multi-process race conditions between Tauri Webview and external headless CLI agents, flock-based advisory locks are required.”

+ Decision ADR-004: Kernel-level flock (.storage.lock) active for all atomic disk writes.

The Solution to Context Fragmentation

Relay replaces lost chat histories and unvetted agent overwrites with structured, durable project memory.

🛡️

Supervised Autonomy (Review Queue)

Agents can inspect full codebase context and propose structural changes, but write operations are held in a human review queue. Accept, adjust, or dismiss proposals with complete visual diffs.

⚡

Three-Way JSON Merge Engine

Concurrent edits by human operators and autonomous background agents are automatically reconciled using a robust 3-way merge algorithm. No overwrites, no torn states.

🔒

Kernel Advisory Locks (fs2)

Guarded by kernel-level flock advisory locks, atomic tempfile writing, and automatic .bak snapshot rotations. Never corrupt your project state during abrupt terminations.

🔑

One-Way SHA-256 Passkeys

Cryptographically random keys (RLY-XXXXXX-...) are shown exactly once. Relay only stores one-way cryptographic SHA-256 hashes on disk, protecting sensitive credentials.

🗂️

5 Scoped Workstream Components

Prevent agent context bloat by partitioning large projects into up to 5 focused workstreams (e.g. Core Engine, API Daemon, Frontend Webview, Security).

📜

90-Day Dual Activity Streams

Track granular per-component updates and view cross-project legacy timelines grouped by calendar week. Automated retention pruning keeps your storage lean and lightning fast.

10 Structured Collaboration Blocks

Durable primitives for recording architectural choices, tracking milestones, and resolving multi-agent deliberations.

📝
Notes
Bulleted technical requirements & guidelines
☑️
Checklists
Action items with review-gated toggling
📅
Events
ISO time-sensitive release milestones
📊
Polls
Agent multi-option voting & rationales
⚖️
Decisions
Architectural Decision Records (ADRs)
⚠️
Risks
Edge cases, debt, & security vulnerabilities
🤝
Handoffs
Explicit context transfers between agents
🔍
Code Inventory
Local repo linking & cached file map
🟢
Heartbeats
5-state visual agent health indicators
💬
Activity Logs
Append-only chronological audit trail
Universal Protocol Bridge

Seamless Integration with Claude, Cursor & Beyond

Relay communicates with your favorite coding assistants via Anthropic's Model Context Protocol (MCP) or standard HTTP REST.

Stdio MCP

Model Context Protocol Bridge

Launch Relay in headless stdio mode directly from Claude Desktop or Cursor. Agents natively discover tools to read briefs, fetch component blocks, and submit review proposals.

{
  "mcpServers": {
    "relay": {
      "command": "/Applications/Relay.app/Contents/MacOS/relay",
      "args": ["--mcp", "--key", "RLY-YOUR-PASSKEY"]
    }
  }
}
LocalHost :4747

High-Performance Axum REST API

A built-in Rust async web daemon bound to 127.0.0.1:4747. Serves a live browser dashboard and lightweight JSON endpoints for curl, Python scripts, or custom agent frameworks.

# Check in an agent to Relay
curl -X POST http://localhost:4747/api/checkin \
  -H "Authorization: Bearer RLY-YOUR-KEY" \
  -H "Content-Type: application/json" \
  -d '{"agentName":"Claude","status":"working"}'

Technical Specifications

Engineered with Rust, Tauri v2, and WebKit for high speed and minimal battery impact.

Operating System macOS 11.0 (Big Sur), 12.0 (Monterey), 13+ (Ventura, Sonoma, Sequoia)
Hardware Architecture Apple Silicon (M1/M2/M3/M4) & Intel x86_64 Universal
Backend Architecture Rust Edition 2024 • Tokio Async Runtime • Axum 0.8 Server
Protocols Supported Anthropic Model Context Protocol (rmcp 3.4.0) • HTTP REST
Storage Root ~/Library/Application Support/com.echosystems.relay/
Telemetry & Tracking Zero analytics, zero tracking, zero third-party calls
Licensing Model One-Time Purchase • Lifetime Local Access