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: $30.00
Shared operating context

Give every agent the same project picture.

Relay keeps the project brief, component scopes, agent roster, and recent activity together in one local workspace. Before work starts, each collaborator can receive the same durable context instead of rebuilding it from scattered chats.

  • Choose exactly which project context is included
  • Keep briefs and component state synchronized locally
  • Package focused context without exposing unrelated work
Relay project context and MCP workspace
Built for focused desks

Keep coordination visible—and under your control.

Relay turns multi-agent work into a calm desktop workflow. Review activity, supervise proposals, and keep the coordination layer on your Mac while your tools continue working in the environments you already use.

  • Review-gated actions preserve human oversight
  • Local-first storage keeps project state on your machine
  • A native workspace stays close without taking over
Relay running in a bright studio workspace

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 $30.00 One-Time Purchase • Lifetime Local Access