Relay — Mobile AI Agent Cockpit 📱⚡

Supervise and steer your AI coding agents from your phone.
Works seamlessly with Google Antigravity IDE, Cursor Composer, and Visual Studio Code (GitHub Copilot & Terminal Agents).

Why Relay?

Modern autonomous coding agents can work for 10–30 minutes at a time, but they frequently pause waiting for human feedback:

• "Which option would you like to proceed with?"
• "Allow command npm test to execute? [y/n]"
• "Review proposed code changes."

You shouldn't have to stay chained to your desktop monitor waiting for prompts. Relay streams your desktop IDE's agent activity straight to a mobile web cockpit, letting you review code diffs, approve terminal commands, and answer questions directly from your phone while walking away.

Key Features

⚡ Sub-100ms Real-Time Streaming

Watch your agent think, invoke tools, run terminal commands, and edit files in real time. Adaptive burst polling and file system watchers ensure updates arrive on your phone instantly.

🎯 1-Tap Human Input & Question Answering

When your agent asks an interactive multiple-choice question or clarification dialog (e.g. Antigravity ask_question, Cursor Composer Questionnaire, or Copilot CLI prompts):

• The question renders with selectable options directly in your mobile cockpit.
• Selecting an answer immediately delivers your choice to the agent and automatically unblocks/dismisses the desktop modal dialog.

🔍 Unified Syntax-Highlighted Diff Viewer

Inspect changes proposed by agents before accepting. Review line additions, removals, and unified diffs on a responsive mobile viewer with full dark mode support.

🛡️ Zero Data Retention & Privacy-First

• No Cloud Storage: Prompts, code files, diffs, and terminal outputs are never stored on any database or server.
• In-Memory Pipe: The bridge server acts exclusively as an encrypted in-memory WebSocket relay.
• Peer Session Tokens: Workstation and phone pair via cryptographically randomized, temporary session keys.

💻 Unified Multi-IDE Engine

Relay automatically detects your running editor environment:

• Google Antigravity IDE (AGY): Direct language server connect-RPC integration + native modal dismissal.
• Cursor: Real-time SQLite state tailing + Composer questionnaire toolbar automation.
• Visual Studio Code: GitHub Copilot chat session monitoring (chatSessions/*.jsonl) + active terminal agent permissions.

☕ Workstation Keep-Awake

Never let your Mac or PC sleep while an autonomous task is running. Relay keeps your machine active during long agent reasoning loops.

Quickstart

1. Install Extension

Install directly from the VS Code Marketplace or Cursor Extensions:

• Search for Relay or acadmyai.relay-ide.
• Or install via CLI:

  code --install-extension acadmyai.relay-ide
  # For Cursor:
  cursor --install-extension acadmyai.relay-ide
  

2. Pair Your Phone

1. Click the Relay icon in your left Activity Bar (or press Cmd+Shift+P / Ctrl+Shift+P and select Relay: Show QR Code to Pair Phone).
2. Scan the QR code using your phone's camera.
3. Your mobile browser will open relay.acadmyai.com and pair with your workstation in under 2 seconds.

3. Walk Away

Leave your desk! As your agent generates code, runs commands, or requires confirmation, your phone will notify you and let you steer with 1 tap.

Extension Settings

Customize Relay behavior in Settings $\rightarrow$ Extensions $\rightarrow$ Relay:

Commands

Access via Cmd+Shift+P / Ctrl+Shift+P:

• Relay: Show QR Code to Pair Phone — Open QR pairing panel.
• Relay: Start Monitoring Session — Begin live session.
• Relay: Stop Session — End active pairing.
• Relay: Restart / Re-sync Connection — Force re-sync with mobile cockpit.
• Relay: Open Mobile Dashboard — Launch web portal directly in browser.

Documentation & Support

• 📖 Documentation & Architecture: relay.acadmyai.com/docs
• 🐛 Issue Tracker: github.com/nickmudit/relay_acadmyai/issues
• 🌐 Website: relay.acadmyai.com

Developed with ❤️ by AcadmyAI.