Kiro Mobile Bridge

A lightweight mobile interface that lets you monitor and control Kiro IDE agent sessions from your phone over LAN, with a live preview of chat, tasks, and code via Chrome DevTools Protocol.

Features

• 📱 Mobile-optimized web interface with tab navigation
• 💬 Chat - View and send messages to Kiro's agent
• 📝 Code - Browse file explorer and view files with syntax highlighting
• 📋 Tasks - View and navigate Kiro spec task files
• 🔄 Real-time updates via WebSocket with adaptive polling

Prerequisites

• Node.js 18+ (uses ES modules)
• Kiro IDE

Quick Start

1. Enable CDP in Kiro

Start Kiro with the remote debugging port enabled:

Run Kiro with debugging port on terminal:

kiro --remote-debugging-port=9000

2. Run with npx (Recommended)

Start Server

npx kiro-mobile-bridge

Alternative: Clone and Run

git clone 
cd kiro-mobile-bridge
npm install
npm start

You'll see output like:

Kiro Mobile Bridge
─────────────────────
Local:   http://localhost:3000
Network: http://192.168.16.106:3000
Open the Network URL on your phone to monitor Kiro.

3. Open on Your Phone

1. Make sure your phone is on the same WiFi network as your computer
2. Open the Network URL (e.g., http://192.168.1.100:3000) in your phone's browser
3. The interface will automatically connect and show your Kiro session
4. Use the tabs to switch between Chat, Code, and Tasks panels

How It Works

┌─────────────────┐     CDP      ┌─────────────────┐
│   Kiro IDE      │◄────────────►│  Bridge Server  │
│ (port 9000-9003)│              │   (port 3000)   │
└─────────────────┘              └────────┬────────┘
                                          │
                                   HTTP + WebSocket
                                          │
                                 ┌────────▼────────┐
                                 │  Mobile Client  │
                                 │   (browser)     │
                                 └─────────────────┘

1. Discovery: Server scans ports 9000-9003, 9222, 9229 for Kiro instances (adaptive: 10s → 30s when stable)
2. Connection: Connects to Kiro via CDP WebSocket
3. Snapshots: Captures chat, editor, and tasks with adaptive polling (1s active → 3s idle)
4. Messages: Injects text into Kiro's chat input via CDP

Troubleshooting

"No sessions available"

• Make sure Kiro is running with --remote-debugging-port=9000
• Check that Kiro has a chat/agent session open
• Wait a few seconds for discovery

Can't connect from phone

• Ensure phone and computer are on the same network
• Check your firewall allows connections on port 3000
• Try the IP address shown in the server output (not localhost)

Linux: Firewall blocking connections

If you're on Linux and can't connect from your phone, your firewall may be blocking port 3000. Allow it with:

# UFW (Ubuntu, Arch, etc.)
sudo ufw allow 3000/tcp

# Or with iptables directly
sudo iptables -A INPUT -p tcp --dport 3000 -j ACCEPT

Security Notes

Only run this on trusted networks.

This is designed for local network use only:

• No authentication
• No HTTPS
• Exposes Kiro's chat interface to anyone on your network

License

MIT