Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 

Repository files navigation

Relay

Build, orchestrate, and operate AI agents.

Relay is a native macOS control plane for agentic software.

It provides a fast, minimal interface for running coding agents, managing work across repositories, reviewing execution, and handling the moments that require your attention.

Instead of making you monitor terminals, sessions, and projects manually, Relay organizes agent activity into an actionable inbox.

Relay is in early development and is not yet ready for production use.

Why Relay?

Coding agents are increasingly capable, but operating them remains fragmented.

Developers often manage agent work across:

  • terminal windows,
  • editor extensions,
  • isolated sessions,
  • shell scripts,
  • provider-specific interfaces,
  • multiple repositories and branches.

As more agents run concurrently, the developer becomes responsible for remembering:

  • what each agent is doing,
  • which project it belongs to,
  • what has completed,
  • what has failed,
  • what is blocked,
  • what requires approval,
  • what should happen next.

Relay removes that mental burden.

It does not replace coding agents.

It provides the system for operating them.

The Agent Inbox

Relay organizes agent activity around a simple question:

What needs my attention right now?

When an agent finishes work, encounters a failure, requests approval, becomes blocked, or needs additional direction, Relay creates a durable inbox item.

Each item explains:

  • what happened,
  • which project and session it belongs to,
  • why your attention is needed,
  • what changed,
  • what actions are available.

Inbox items may represent:

  • completed work ready for review,
  • approval requests,
  • failed tasks,
  • blocked sessions,
  • questions from agents,
  • validation results,
  • sessions awaiting another instruction.

The inbox is not a chronological stream of every event.

It is a prioritized queue of unresolved human attention.

Relay should make operating many agents feel calmer than operating one agent manually.

Direction

Relay is being designed around several core capabilities:

  • local repository workspaces,
  • multiple concurrent agent sessions,
  • a unified agent inbox,
  • structured execution history,
  • tool-call and process visibility,
  • human approval and intervention,
  • repository change and diff review,
  • agent-agnostic integrations,
  • future remote access from iPhone and iPad.

The initial release will be local-first and macOS-only.

Native by Design

Relay is built with Swift, SwiftUI, and AppKit.

It is not a web application packaged inside a desktop shell.

The goal is to create a product that feels at home on macOS, including:

  • fast startup,
  • responsive interaction,
  • native menus,
  • keyboard-first workflows,
  • platform-standard navigation,
  • predictable window behavior,
  • accessibility,
  • native text handling,
  • restrained animation.

Relay should feel closer to Apple Notes, Finder, or Xcode than to a browser-based control panel.

Product Principles

Attention over activity

Relay should not require users to monitor every running session.

Most agent events do not require human involvement. Relay should keep routine activity in the background and surface only the moments that require awareness, judgment, or action.

Local first

Relay should provide meaningful value without requiring an account or hosted service.

Repositories, sessions, process output, and execution history remain local unless the user explicitly enables remote capabilities.

Agent agnostic

Relay should not depend on one model provider, coding agent, or orchestration framework.

Agents should integrate through adapters that map their execution into a shared Relay model while preserving provider-specific capabilities.

Human control

Agents should remain interruptible and reviewable.

Relay should support actions such as:

  • approve,
  • reject,
  • pause,
  • cancel,
  • retry,
  • redirect,
  • continue.

Automation should increase leverage without removing human authority.

Minimal interface

Relay should expose complexity progressively.

The primary application structure should remain simple:

Inbox → Projects → Sessions → Active Work

Advanced controls should live behind native menus, keyboard commands, inspectors, context menus, sheets, and command-driven interactions.

Technology

  • Swift
  • SwiftUI
  • AppKit
  • Swift Concurrency
  • Swift Package Manager
  • Local persistence

Project Status

Relay is currently in the architecture and early implementation phase.

APIs, internal structures, integrations, and product scope are expected to change.

Documentation

Contributing

Relay is not yet ready for external contributions.

Contribution guidance will be added after the product direction, development workflow, and first complete vertical slice are established.

License

A license has not yet been selected.

About

Build, orchestrate, and operate AI agents.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors