Hotline

Local WebSocket dev bridge for React Native apps. Lets CLI tools and AI agents send commands to and query data from running apps in real time.

Reference Files

• references/integration.md — How to add hotline to a React Native / Expo project
• references/swift-integration.md — How to add hotline to a Swift / SwiftUI app (no npm, pure URLSession)
• references/handlers.md — Standard handlers and the handler format
• references/agent-usage.md — CLI commands and automation patterns for AI agents
• references/events.md — Event system for real-time app-to-agent communication
• references/device-automation.md — Serialized simulator queue, action scripts, screenshots, and Discord video summaries

Quick Reference

• Import: @dawsson/hotline/src/client
• Server port: 8675
• Handler format: { handler, fields, description } — no bare functions
• Production safe: no-op when __DEV__ is false
• ping is built-in, no need to register it
• For duplicate simulators of the same app, register target.deviceId and target agents with --udid
• Device automation: hotline device run --agent <id> --script <steps.json> --discord-webhook <url>