Modern, privacy-first mobile companion for supervising AI coding assistants (Google Antigravity) while away from your desk (AFK) on your local Wi-Fi network.
- Desktop IDE Extension: AgentPulse-VS-Code (VS Code / Antigravity IDE)
When developers fire off long-running prompts in modern AI coding agents, they frequently step away from their desks. AgentPulse Mobile bridges your phone directly to your desktop development session over local Wi-Fi:
- Live Stream Chat & Reasoning: Read the agent's real-time thoughts, stream chunks, and executing tool calls.
- Instant Completion Alerts: Receive haptic pulses, vibration patterns, and a prominent banner when the agent completes its turn (
status: 'done'), signaling that it is time to return to your desk. - Single Connection URI Pairing: Simply copy the connection URI from your desktop extension (
ws://192.168.x.x:49152?token=...) and paste it into one single input field. - Screen Keep-Awake: Prevents iOS and Android from sleeping the display and suspending the WebSocket connection while the agent is actively
'thinking'or'running_tool'. - Persistent Hardware Security: Uses
expo-secure-storeto safely remember your LAN server URL, pairing token, and settings in your device's hardware enclave (iOS Keychain / Android Keystore) so you never need to re-type pairing details on every launch. - Automatic History Hydration: Pulls recent conversation history on initial handshake (
INIT_SESSION) so reconnecting never leaves you with an empty screen. - Zero Cloud Storage: Direct device-to-workstation architecture over LAN. No prompts, code, or tokens are ever uploaded to cloud servers.
Copy the pairing URI from the desktop extension and paste it into the mobile companion:
Monitor agent thoughts and tool calls in real time, with instant completion notifications when the turn finishes:
πΉ Full Video Walkthrough: Download or Watch AgentPulse.mov
| Assistant | Status | Notes |
|---|---|---|
| Google Antigravity | Supported | Live thought streaming, tool execution indicators, history hydration, and completion alerts |
| Other Coding Agents | π‘ Planned | Support for additional coding assistants is planned and will be coming in future updates |
flowchart LR
subgraph Desktop["Workstation (Desktop / Laptop)"]
subgraph IDE["VS Code / Antigravity IDE"]
AG["Antigravity Agent Engine"]
LOG["transcript.jsonl (Session Log)"]
EXT["AgentPulse Extension Daemon<br/>(ws://0.0.0.0:49152)"]
PWR["OS Keep-Awake Lock<br/>(Win32 / macOS Caffeinate)"]
end
end
subgraph Network["Local Area Network (Home Wi-Fi)"]
CONN["Direct WebSocket Connection<br/>ws://192.168.x.x:49152?token=..."]
end
subgraph Mobile["Mobile Device (iOS / Android)"]
subgraph App["AgentPulse Mobile App"]
SOCK["useAgentSocket (Client)"]
SEC["expo-secure-store (Keychain / Keystore)"]
SCR["expo-keep-awake (Display Lock)"]
ALERT["expo-haptics & Vibration<br/>('Task Completed' Banner)"]
UI["Live Chat & Stream Feed"]
end
end
AG -->|writes steps| LOG
LOG -->|file tailing & mtime stat| EXT
EXT -->|prevent sleep during work| PWR
EXT <==>|authenticated handshake| CONN
CONN <==>|real-time streaming| SOCK
SOCK -->|hydrate history & tokens| UI
SOCK -->|turn active: display awake| SCR
SOCK -->|turn done: alert & haptics| ALERT
SEC -.->|restore saved pairing link| SOCK
- Framework: React Native 0.88+ with Expo 58+
- Language: TypeScript (Strict Mode)
- Storage:
expo-secure-store(Hardware Keychain / Keystore) - Display & Alerts:
expo-keep-awake,expo-haptics - Networking: Native WebSockets
- Testing: Jest +
@testing-library/react-native+jest-expo
- Node.js 20+ installed
- Workstation running AgentPulse-VS-Code on the same local Wi-Fi router
- Android phone (or emulator) or iPhone with Expo Go installed (free on App Store / Google Play)
# Navigate to mobile app directory
cd app
# Install dependencies
npm install# Start Metro bundler
npx expo start- Physical iPhone / Android: Open camera or the Expo Go app and scan the QR code displayed in your terminal.
- Android Emulator: Press a in terminal or run
npx expo start --android. - iOS Simulator: Press i in terminal or run
npx expo start --ios. - Web (Testing): Press w in terminal.
- In your desktop IDE running AgentPulse-VS-Code, run
AgentPulse: Copy Connection URI(or click "Copy Connection URI" in the sidebar). - In the mobile app, tap Pair (or Settings) in the top-right corner.
- Paste the single connection link into the Connection URI input:
ws://192.168.x.x:49152?token=... - Tap Connect. The app stores the credentials in hardware secure storage and begins streaming agent activity in real-time.
# Run unit and component test suites (27 tests passing)
npm test -- --watchAll=false
# Run TypeScript type check
npx tsc --noEmit./
βββ assets/ # App icons and splash screens
βββ src/
β βββ components/ # AgentStatusBar, ChatMessageBubble, CompletionBanner, ConnectionModal, PromptBar, ToolApprovalCard
β βββ hooks/ # useAgentSocket, useAgentKeepAwake, useCompletionAlert
β βββ services/ # storage.ts (expo-secure-store wrapper)
β βββ types/ # TypeScript models (AgentExecutionStatus, ChatMessage, ToolCallRequest)
βββ __tests__/ # Jest test suites (App, Components, KeepAwake, CompletionAlert, Storage)
βββ App.tsx # Root application entrypoint
βββ app.json # Expo configuration & plugins
βββ AGENTS.md # AI Agent guidelines & context cache
βββ plan.md # Development roadmap and step checklist
- Hardware Enclave: All pairing tokens and host configurations are stored securely with
expo-secure-store. - Read-Only Inspection: The mobile app acts strictly as an observation monitor. It cannot inject arbitrary commands or delete files on your workstation.
- No External Cloud: All communication is direct peer-to-workstation over your private local area network (LAN).
This project is licensed under the MIT License.

