relayd

Product Introduction

1. Definition: relayd is a lightweight daemon (agent control software) that creates secure tunnels between local AI coding agents (like Codex) and a mobile Progressive Web App (PWA). It enables remote monitoring and control of automated development workflows.
2. Core Value Proposition: relayd solves the "indie dev paradox" by freeing developers from desk-bound monitoring. It provides real-time push notifications and mobile control for AI agents, ensuring productivity continuity without compromising code privacy.

Main Features

1. Real-Time Agent Status Dashboard:
   Monitors all active Codex agents across workspaces via WebSocket connections. Displays live status (running/needs input/completed), execution duration, and workspace context. Uses Cloudflare Durable Objects for state synchronization.
2. Push Notification System:
   Sends encrypted mobile alerts via PWA service workers when agents finish tasks or require input. Generates preview snippets without storing code (metadata-only). Supports iOS/Android through browser-based push APIs.
3. One-Tap Continuation Protocol:
   Enables resuming stuck agents directly from mobile. Taps trigger encrypted commands routed through authenticated tunnels to local CLI agents. Uses end-to-end session isolation per relay connection.
4. Privacy-First Architecture:
   Zero code storage; only retains relay names, OS metadata, and workspace paths. Data tunnels use per-session encryption. Local agents operate independently—service outages don’t disrupt workflows.
5. Mobile-Optimized PWA:
   Installable dashboard with offline caching. Bypasses app stores using Web App Manifest standards. Responsive UI shows code diffs, errors, and agent outputs in collapsible threads.

Problems Solved

1. Pain Point: Productivity loss from manual agent monitoring (e.g., missed overnight completions blocking workflows).
2. Target Audience: Indie developers using AI coding tools (Codex/OpenCode), solo founders managing multiple projects, and remote teams needing asynchronous collaboration.
3. Use Cases:
   • Receiving dinner-time alerts to approve OAuth implementation
   • Choosing libraries for landing pages via mobile during commutes
   • Restarting test suites after failures from any location

Unique Advantages

1. Differentiation: Unlike passive monitoring tools (e.g., Grafana), relayd enables active intervention. Competitors lack mobile control, agent-specific context, and privacy guarantees.
2. Key Innovation: Secure "command tunneling" technology that proxies inputs/outputs without data persistence. Combines PWA convenience with local execution security.

Frequently Asked Questions (FAQ)

1. Does relayd store my code or API keys?
   No. relayd only retains minimal metadata (workspace names, relay status). Code remains on your local machine; tunnels transmit encrypted real-time streams.
2. Can I use relayd with non-Codex agents?
   Currently optimized for Codex, but CLI agent support (e.g., OpenCode) is under evaluation. Custom agent integration requires API adaptation.
3. How secure are the mobile-to-local connections?
   Tunnels use session-specific encryption scoped to your account. However, running relayd exposes local services—sandboxing is recommended.
4. What happens if my phone loses internet?
   The PWA caches notifications offline. Commands queue until connectivity resumes; local agents continue operating unaffected.
5. Is relayd compliant with EU data regulations?
   Yes. No user code/logs are stored or processed. Metadata resides in GDPR-compliant Cloudflare data centers.