VS Code & Antigravity IDE companion extension bridging your desktop AI sessions to your mobile phone over local Wi-Fi while AFK.
- Mobile Companion App: AgentPulse-Mobile (React Native / Expo)
When you run complex, multi-step agent prompts in Google Antigravity, you shouldn't have to stay glued to your desk. AgentPulse runs a lightweight local broadcast daemon inside your IDE that:
- Tails Antigravity Transcripts: Streams real-time tokens, internal reasoning, and tool calls directly from Antigravity's structured
%USERPROFILE%\.gemini\antigravity\brain\<id>\.system_generated\logs\transcript.jsonlsession logs. - Detects Task Completion: Emits an instant
donestatus event when the agent finishes its response turn. - Instant State Handshake (
INIT_SESSION): Automatically sends existing conversation history and current status to newly connected or reconnecting mobile clients so the chat screen populates immediately. - Local LAN Broadcast: Automatically resolves your workstation's physical Wi-Fi/Ethernet IPv4 address (filtering out WSL/Docker virtual adapters) and generates a local pairing URI (
ws://192.168.x.x:49152?token=...). - Prevents Laptop Sleep: Engages OS-level keep-awake power assertions (Windows
SetThreadExecutionState/ macOScaffeinate) while an agent task is active. - Single Copy Command: Provides
AgentPulse: Copy Connection URIto copy your complete pairing link in 1 click. - Zero Cloud Storage & Privacy-First: Runs 100% locally on your machine with ephemeral 256-bit token authentication (
crypto.randomBytes(32)+timingSafeEqual). No chats or code are ever sent to an external database.
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
- Platform: VS Code Extension API (^1.93.0) + Antigravity IDE
- Language: TypeScript (Strict ES2022)
- WebSocket Server:
wsbound to0.0.0.0 - Security: Cryptographic pairing tokens (
crypto.randomBytes(32)+ constant-time comparison) - Testing: Jest +
ts-jest
- Node.js 20+ installed
- VS Code or Google Antigravity IDE installed
- AgentPulse-Mobile running on your phone connected to the same Wi-Fi router
# Navigate to extension directory
cd extension
# Install dependencies
npm install
# Compile TypeScript
npm run compile
# (Optional) Package fresh .vsix extension file
npm run package- Open the
extension/folder in VS Code or Antigravity IDE. - Press F5 to launch a new Extension Development Host window.
- Open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P) and run:
AgentPulse: Start Mobile Companion ServerAgentPulse: Copy Connection URI(or open the AgentPulse sidebar view)
| Command | Title | Description |
|---|---|---|
agentpulse.startServer |
AgentPulse: Start Mobile Companion Server |
Starts the local WebSocket companion daemon on your LAN IP. |
agentpulse.showPairingQr |
AgentPulse: Show Mobile Pairing QR Code |
Displays a pairing QR code and LAN URI in VS Code. |
agentpulse.copyConnectionUri |
AgentPulse: Copy Connection URI |
Copies the full connection URI (ws://192.168.x.x:49152?token=...) to clipboard in one click. |
agentpulse.stopServer |
AgentPulse: Stop Server |
Shuts down the daemon and releases keep-awake assertions. |
# Run Jest unit test suite (25 tests passing)
npm test
# Run TypeScript compile check
npm run compile./
├── src/
│ ├── server/ # WebSocket daemon & network tools
│ │ ├── wss.ts # Server instance & INIT_SESSION handshake
│ │ ├── auth.ts # Token generation & constant-time verification
│ │ ├── network.ts # Physical LAN IPv4 resolver
│ │ ├── sidebarView.ts # Webview sidebar with QR code and status
│ │ └── qr.ts # Terminal & webview QR code generation
│ ├── adapters/ # AI assistant observers
│ │ ├── base.ts # AgentAdapter interface
│ │ ├── antigravity.ts # Antigravity transcript tailing & history loader
│ │ └── copilot.ts # GitHub Copilot Chat listener
│ ├── keepawake/ # Windows & macOS keep-awake engine
│ ├── extension.ts # Extension activation and command registration
│ └── test/ # Jest test suite (25 tests)
├── package.json # Extension manifest & commands
├── tsconfig.json # TypeScript configuration
├── AGENTS.md # Context cache for AI agents
└── plan.md # Development roadmap and step checklist
- LAN Binding with Ephemeral Secret: Binds to
0.0.0.0so mobile devices on the same Wi-Fi router can reach the server. Every pairing session creates an ephemeral 256-bit cryptographic token. Connections without this token are immediately rejected. - Read-Only Broadcast: The extension does not accept code modification or shell command execution commands from the mobile client. It strictly streams agent status, thoughts, and logs.
- Zero External Cloud: No third-party servers, no relay telemetry, no external databases.
This project is licensed under the MIT License.

