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

$3

Start Kiro with the remote debugging port enabled:

Run Kiro with debugging port on terminal:
``bash
kiro --remote-debugging-port=9000
`

$3

Start Server

`bash
npx kiro-mobile-bridge
`

#### Alternative: Clone and Run

`bash
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

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:

`bash


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