A simple mobile web interface for monitoring Kiro IDE agent sessions from your phone over LAN
npm install kiro-mobile-bridgeA 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.
- š± 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
- Node.js 18+ (uses ES modules)
- Kiro IDE
Start Kiro with the remote debugging port enabled:
Run Kiro with debugging port on terminal:
``bash`
kiro --remote-debugging-port=9000
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.
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
#### "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:
`bashUFW (Ubuntu, Arch, etc.)
sudo ufw allow 3000/tcp
#### 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
MIT