Skip to content

About

πŸ“± Real-time mobile session monitor for AI coding agents. Stream Google Antigravity thoughts and get instant task completion alerts over local Wi-Fi while AFK.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

28 Commits

Folders and files

Repository files navigation

AgentPulse Mobile (agentpulse-mobile)

Modern, privacy-first mobile companion for supervising AI coding assistants (Google Antigravity) while away from your desk (AFK) on your local Wi-Fi network.

TypeScript Expo React Native License: MIT Companion Desktop Extension


πŸ”— Sister Repository


πŸ“± Overview

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-store to 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.

πŸ“Έ Demo & Screenshots

1. One-Click Pairing

Copy the pairing URI from the desktop extension and paste it into the mobile companion:

Paste URI into mobile app

2. Live Thought Stream & Completion Alert

Monitor agent thoughts and tool calls in real time, with instant completion notifications when the turn finishes:

Task completed notification

πŸ“Ή Full Video Walkthrough: Download or Watch AgentPulse.mov


πŸ€– Supported AI Coding Assistants

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

πŸ“ Architecture & Connection Flow

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
Loading

πŸ› οΈ Tech Stack

  • 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

πŸš€ Getting Started

Prerequisites

  • 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)

1. Installation

# Navigate to mobile app directory
cd app

# Install dependencies
npm install

2. Running the Development Server

# Start Metro bundler
npx expo start

3. Launching on Devices

  • 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.

4. Pairing with Desktop

  1. In your desktop IDE running AgentPulse-VS-Code, run AgentPulse: Copy Connection URI (or click "Copy Connection URI" in the sidebar).
  2. In the mobile app, tap Pair (or Settings) in the top-right corner.
  3. Paste the single connection link into the Connection URI input:
    ws://192.168.x.x:49152?token=...
    
  4. Tap Connect. The app stores the credentials in hardware secure storage and begins streaming agent activity in real-time.

πŸ§ͺ Testing & Quality Assurance

# Run unit and component test suites (27 tests passing)
npm test -- --watchAll=false

# Run TypeScript type check
npx tsc --noEmit

πŸ“ Repository Structure

./
β”œβ”€β”€ 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

πŸ”’ Security Architecture

  1. Hardware Enclave: All pairing tokens and host configurations are stored securely with expo-secure-store.
  2. Read-Only Inspection: The mobile app acts strictly as an observation monitor. It cannot inject arbitrary commands or delete files on your workstation.
  3. No External Cloud: All communication is direct peer-to-workstation over your private local area network (LAN).

πŸ“„ License

This project is licensed under the MIT License.

About

πŸ“± Real-time mobile session monitor for AI coding agents. Stream Google Antigravity thoughts and get instant task completion alerts over local Wi-Fi while AFK.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages