kiro-mobile-bridge 1.0.6 → 1.0.8
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 +9 -21
- package/package.json +1 -1
- package/src/public/index.html +1167 -1598
- package/src/routes/api.js +358 -0
- package/src/server.js +271 -2566
- package/src/services/cdp.js +156 -0
- package/src/services/click.js +282 -0
- package/src/services/message.js +206 -0
- package/src/services/snapshot.js +331 -0
- package/src/utils/hash.js +22 -0
- package/src/utils/network.js +20 -0
package/README.md
CHANGED
|
@@ -2,6 +2,8 @@
|
|
|
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
|
|
@@ -31,20 +33,6 @@ Option 1: **Run Kiro with debugging port:**
|
|
|
31
33
|
/opt/Kiro/kiro --remote-debugging-port=9000
|
|
32
34
|
```
|
|
33
35
|
|
|
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
36
|
### 2. Run with npx (Recommended)
|
|
49
37
|
|
|
50
38
|
No installation needed! Just run:
|
|
@@ -53,7 +41,7 @@ No installation needed! Just run:
|
|
|
53
41
|
npx kiro-mobile-bridge
|
|
54
42
|
```
|
|
55
43
|
|
|
56
|
-
|
|
44
|
+
#### Alternative: Clone and Run
|
|
57
45
|
|
|
58
46
|
```bash
|
|
59
47
|
git clone
|
|
@@ -80,7 +68,7 @@ Open the Network URL on your phone to monitor Kiro.
|
|
|
80
68
|
3. The interface will automatically connect and show your Kiro chat
|
|
81
69
|
|
|
82
70
|
|
|
83
|
-
|
|
71
|
+
#### How It Works
|
|
84
72
|
|
|
85
73
|
```
|
|
86
74
|
┌─────────────────┐ CDP ┌─────────────────┐
|
|
@@ -96,20 +84,20 @@ Open the Network URL on your phone to monitor Kiro.
|
|
|
96
84
|
└─────────────────┘
|
|
97
85
|
```
|
|
98
86
|
|
|
99
|
-
1. **Discovery**: Server scans ports 9000-9003
|
|
87
|
+
1. **Discovery**: Server scans ports 9000-9003 for Kiro instances (adaptive: 10s → 30s when stable)
|
|
100
88
|
2. **Connection**: Connects to Kiro via CDP WebSocket
|
|
101
|
-
3. **Snapshots**: Captures chat HTML
|
|
89
|
+
3. **Snapshots**: Captures chat HTML with adaptive polling (1s active → 3s idle), broadcasts changes
|
|
102
90
|
4. **Messages**: Injects text into Kiro's chat input via CDP
|
|
103
91
|
|
|
104
92
|
## Troubleshooting
|
|
105
93
|
|
|
106
|
-
|
|
94
|
+
#### "No sessions available"
|
|
107
95
|
|
|
108
96
|
- Make sure Kiro is running with `--remote-debugging-port=9000`
|
|
109
97
|
- Check that Kiro has a chat/agent session open
|
|
110
98
|
- Wait a few seconds for discovery
|
|
111
99
|
|
|
112
|
-
|
|
100
|
+
#### Can't connect from phone
|
|
113
101
|
|
|
114
102
|
- Ensure phone and computer are on the **same network**
|
|
115
103
|
- Check your firewall allows connections on port 3000
|
|
@@ -117,7 +105,7 @@ Open the Network URL on your phone to monitor Kiro.
|
|
|
117
105
|
|
|
118
106
|
## Security Notes
|
|
119
107
|
|
|
120
|
-
|
|
108
|
+
**This is designed for local network use only:**
|
|
121
109
|
|
|
122
110
|
- No authentication
|
|
123
111
|
- No HTTPS
|