kiro-mobile-bridge 1.0.7 → 1.0.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +16 -24
- package/package.json +1 -1
- package/src/public/index.html +1414 -1628
- package/src/routes/api.js +539 -0
- package/src/server.js +287 -2593
- package/src/services/cdp.js +210 -0
- package/src/services/click.js +533 -0
- package/src/services/message.js +214 -0
- package/src/services/snapshot.js +370 -0
- package/src/utils/constants.js +116 -0
- package/src/utils/hash.js +34 -0
- package/src/utils/network.js +64 -0
- package/src/utils/security.js +160 -0
package/README.md
CHANGED
|
@@ -2,12 +2,17 @@
|
|
|
2
2
|
|
|
3
3
|
A mobile web interface for monitoring Kiro IDE agent sessions from your phone over LAN. Captures snapshots of the chat interface, file explorer, and editor via Chrome DevTools Protocol (CDP) and lets you interact remotely.
|
|
4
4
|
|
|
5
|
+
<img width="1829" height="1065" alt="Untitled design (1)" src="https://github.com/user-attachments/assets/0590c332-80e1-4874-b27d-e7babe6202c8" />
|
|
6
|
+
|
|
5
7
|
## Features
|
|
6
8
|
|
|
7
9
|
- 📱 Mobile-optimized web interface with tab navigation
|
|
8
10
|
- 💬 **Chat Panel** - View and send messages to Kiro's agent
|
|
9
|
-
- 📝 **
|
|
10
|
-
-
|
|
11
|
+
- 📝 **Code Panel** - Browse file explorer and view files with syntax highlighting
|
|
12
|
+
- 📋 **Tasks Panel** - View and navigate Kiro spec task files
|
|
13
|
+
- 🔄 Real-time updates via WebSocket with adaptive polling
|
|
14
|
+
- 🔍 Auto-discovers Kiro instances on ports 9000-9003, 9222, 9229
|
|
15
|
+
- 🎨 Preserves original Kiro styling
|
|
11
16
|
|
|
12
17
|
## Prerequisites
|
|
13
18
|
|
|
@@ -31,20 +36,6 @@ Option 1: **Run Kiro with debugging port:**
|
|
|
31
36
|
/opt/Kiro/kiro --remote-debugging-port=9000
|
|
32
37
|
```
|
|
33
38
|
|
|
34
|
-
Option 2: **Finding Kiro's location:**
|
|
35
|
-
|
|
36
|
-
```bash
|
|
37
|
-
where kiro # Windows (CMD)
|
|
38
|
-
which kiro # macOS/Linux
|
|
39
|
-
```
|
|
40
|
-
|
|
41
|
-
Then use the path in your command:
|
|
42
|
-
|
|
43
|
-
```bash
|
|
44
|
-
# Example
|
|
45
|
-
"C:\Users\YourName\AppData\Local\Programs\Kiro\Kiro.exe" --remote-debugging-port=9000
|
|
46
|
-
```
|
|
47
|
-
|
|
48
39
|
### 2. Run with npx (Recommended)
|
|
49
40
|
|
|
50
41
|
No installation needed! Just run:
|
|
@@ -53,7 +44,7 @@ No installation needed! Just run:
|
|
|
53
44
|
npx kiro-mobile-bridge
|
|
54
45
|
```
|
|
55
46
|
|
|
56
|
-
|
|
47
|
+
#### Alternative: Clone and Run
|
|
57
48
|
|
|
58
49
|
```bash
|
|
59
50
|
git clone
|
|
@@ -77,10 +68,11 @@ Open the Network URL on your phone to monitor Kiro.
|
|
|
77
68
|
|
|
78
69
|
1. Make sure your phone is on the **same WiFi network** as your computer
|
|
79
70
|
2. Open the **Network URL** (e.g., `http://192.168.1.100:3000`) in your phone's browser
|
|
80
|
-
3. The interface will automatically connect and show your Kiro
|
|
71
|
+
3. The interface will automatically connect and show your Kiro session
|
|
72
|
+
4. Use the tabs to switch between Chat, Code, and Tasks panels
|
|
81
73
|
|
|
82
74
|
|
|
83
|
-
|
|
75
|
+
#### How It Works
|
|
84
76
|
|
|
85
77
|
```
|
|
86
78
|
┌─────────────────┐ CDP ┌─────────────────┐
|
|
@@ -96,20 +88,20 @@ Open the Network URL on your phone to monitor Kiro.
|
|
|
96
88
|
└─────────────────┘
|
|
97
89
|
```
|
|
98
90
|
|
|
99
|
-
1. **Discovery**: Server scans ports 9000-9003
|
|
91
|
+
1. **Discovery**: Server scans ports 9000-9003, 9222, 9229 for Kiro instances (adaptive: 10s → 30s when stable)
|
|
100
92
|
2. **Connection**: Connects to Kiro via CDP WebSocket
|
|
101
|
-
3. **Snapshots**: Captures chat
|
|
93
|
+
3. **Snapshots**: Captures chat, editor, and tasks with adaptive polling (1s active → 3s idle)
|
|
102
94
|
4. **Messages**: Injects text into Kiro's chat input via CDP
|
|
103
95
|
|
|
104
96
|
## Troubleshooting
|
|
105
97
|
|
|
106
|
-
|
|
98
|
+
#### "No sessions available"
|
|
107
99
|
|
|
108
100
|
- Make sure Kiro is running with `--remote-debugging-port=9000`
|
|
109
101
|
- Check that Kiro has a chat/agent session open
|
|
110
102
|
- Wait a few seconds for discovery
|
|
111
103
|
|
|
112
|
-
|
|
104
|
+
#### Can't connect from phone
|
|
113
105
|
|
|
114
106
|
- Ensure phone and computer are on the **same network**
|
|
115
107
|
- Check your firewall allows connections on port 3000
|
|
@@ -117,7 +109,7 @@ Open the Network URL on your phone to monitor Kiro.
|
|
|
117
109
|
|
|
118
110
|
## Security Notes
|
|
119
111
|
|
|
120
|
-
|
|
112
|
+
**This is designed for local network use only:**
|
|
121
113
|
|
|
122
114
|
- No authentication
|
|
123
115
|
- No HTTPS
|
package/package.json
CHANGED