react-native-ai-devtools 1.4.32 → 1.4.33
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 +81 -74
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -8,10 +8,17 @@ An MCP server that gives AI assistants real-time access to a running React Nativ
|
|
|
8
8
|
|
|
9
9
|
**Positioning:** This is not a debugger. This is not a QA tool. This is a Runtime AI Bridge — the missing layer between AI coding assistants and live mobile applications. Without it, your AI assistant is blind. With it, the AI sees everything happening in your app in real time.
|
|
10
10
|
|
|
11
|
+
|
|
12
|
+
## Get started
|
|
13
|
+
|
|
14
|
+
1. [Setup rn-ai-devtools as an MCP server for your agent of choice](#claude-code-setup)
|
|
15
|
+
2. [Setup UI automation helpers](#ios-simulator--ui-automation-setup)
|
|
16
|
+
|
|
11
17
|
## Feedback & Feature Requests
|
|
12
18
|
|
|
13
19
|
Have an idea or found something that could be better? Head over to [GitHub Discussions](https://github.com/igorzheludkov/react-native-ai-devtools/discussions) to share feedback, request features, and vote on what gets built next.
|
|
14
20
|
|
|
21
|
+
|
|
15
22
|
## Features
|
|
16
23
|
|
|
17
24
|
### Runtime Interaction
|
|
@@ -46,7 +53,80 @@ Have an idea or found something that could be better? Head over to [GitHub Discu
|
|
|
46
53
|
- **Efficient Buffering** - Circular buffers: 500 logs, 200 network requests
|
|
47
54
|
- **Platform Support** - Expo SDK 54+ (Bridgeless) and React Native 0.70+ (Hermes)
|
|
48
55
|
|
|
49
|
-
##
|
|
56
|
+
## Setup
|
|
57
|
+
|
|
58
|
+
### Claude Code Setup
|
|
59
|
+
|
|
60
|
+
No installation required - Claude Code uses `npx` to run the latest version automatically.
|
|
61
|
+
|
|
62
|
+
#### Global (all projects)
|
|
63
|
+
|
|
64
|
+
```bash
|
|
65
|
+
claude mcp add rn-ai-devtools --scope user -- npx react-native-ai-devtools
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
#### Project-specific
|
|
69
|
+
|
|
70
|
+
```bash
|
|
71
|
+
claude mcp add rn-ai-devtools --scope project -- npx react-native-ai-devtools
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
#### Manual Configuration
|
|
75
|
+
|
|
76
|
+
Add to `~/.claude.json` (user scope) or `.mcp.json` (project scope):
|
|
77
|
+
|
|
78
|
+
```json
|
|
79
|
+
{
|
|
80
|
+
"mcpServers": {
|
|
81
|
+
"rn-ai-devtools": {
|
|
82
|
+
"type": "stdio",
|
|
83
|
+
"command": "npx",
|
|
84
|
+
"args": ["react-native-ai-devtools"]
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
Restart Claude Code after adding the configuration.
|
|
91
|
+
|
|
92
|
+
### VS Code Copilot Setup
|
|
93
|
+
|
|
94
|
+
Requires VS Code 1.102+ with Copilot ([docs](https://code.visualstudio.com/docs/copilot/customization/mcp-servers)).
|
|
95
|
+
|
|
96
|
+
**Via Command Palette**: `Cmd+Shift+P` → "MCP: Add Server"
|
|
97
|
+
|
|
98
|
+
**Manual config** - add to `.vscode/mcp.json`:
|
|
99
|
+
|
|
100
|
+
```json
|
|
101
|
+
{
|
|
102
|
+
"servers": {
|
|
103
|
+
"rn-ai-devtools": {
|
|
104
|
+
"type": "stdio",
|
|
105
|
+
"command": "npx",
|
|
106
|
+
"args": ["-y", "react-native-ai-devtools"]
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
### Cursor Setup
|
|
113
|
+
|
|
114
|
+
[Docs](https://docs.cursor.com/context/model-context-protocol)
|
|
115
|
+
|
|
116
|
+
**Via Command Palette**: `Cmd+Shift+P` → "View: Open MCP Settings"
|
|
117
|
+
|
|
118
|
+
**Manual config** - add to `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global):
|
|
119
|
+
|
|
120
|
+
```json
|
|
121
|
+
{
|
|
122
|
+
"mcpServers": {
|
|
123
|
+
"rn-ai-devtools": {
|
|
124
|
+
"command": "npx",
|
|
125
|
+
"args": ["-y", "react-native-ai-devtools"]
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
```
|
|
50
130
|
|
|
51
131
|
### Android
|
|
52
132
|
|
|
@@ -122,79 +202,6 @@ IDB is the default driver — no `IOS_DRIVER` env var needed.
|
|
|
122
202
|
- **iOS UI automation**: [Facebook IDB](https://fbidb.io/) (`brew install idb-companion`) or [AXe CLI](https://github.com/cameroncooke/AXe) (`brew install cameroncooke/axe/axe`) — required for tap, swipe, text input, accessibility on iOS Simulator
|
|
123
203
|
- **Optional for offline OCR fallback**: Python 3.6+ (only needed when cloud OCR is unavailable, see [OCR Setup](#ocr-text-extraction))
|
|
124
204
|
|
|
125
|
-
## Claude Code Setup
|
|
126
|
-
|
|
127
|
-
No installation required - Claude Code uses `npx` to run the latest version automatically.
|
|
128
|
-
|
|
129
|
-
### Global (all projects)
|
|
130
|
-
|
|
131
|
-
```bash
|
|
132
|
-
claude mcp add rn-ai-devtools --scope user -- npx react-native-ai-devtools
|
|
133
|
-
```
|
|
134
|
-
|
|
135
|
-
### Project-specific
|
|
136
|
-
|
|
137
|
-
```bash
|
|
138
|
-
claude mcp add rn-ai-devtools --scope project -- npx react-native-ai-devtools
|
|
139
|
-
```
|
|
140
|
-
|
|
141
|
-
### Manual Configuration
|
|
142
|
-
|
|
143
|
-
Add to `~/.claude.json` (user scope) or `.mcp.json` (project scope):
|
|
144
|
-
|
|
145
|
-
```json
|
|
146
|
-
{
|
|
147
|
-
"mcpServers": {
|
|
148
|
-
"rn-ai-devtools": {
|
|
149
|
-
"type": "stdio",
|
|
150
|
-
"command": "npx",
|
|
151
|
-
"args": ["react-native-ai-devtools"]
|
|
152
|
-
}
|
|
153
|
-
}
|
|
154
|
-
}
|
|
155
|
-
```
|
|
156
|
-
|
|
157
|
-
Restart Claude Code after adding the configuration.
|
|
158
|
-
|
|
159
|
-
## VS Code Copilot Setup
|
|
160
|
-
|
|
161
|
-
Requires VS Code 1.102+ with Copilot ([docs](https://code.visualstudio.com/docs/copilot/customization/mcp-servers)).
|
|
162
|
-
|
|
163
|
-
**Via Command Palette**: `Cmd+Shift+P` → "MCP: Add Server"
|
|
164
|
-
|
|
165
|
-
**Manual config** - add to `.vscode/mcp.json`:
|
|
166
|
-
|
|
167
|
-
```json
|
|
168
|
-
{
|
|
169
|
-
"servers": {
|
|
170
|
-
"rn-ai-devtools": {
|
|
171
|
-
"type": "stdio",
|
|
172
|
-
"command": "npx",
|
|
173
|
-
"args": ["-y", "react-native-ai-devtools"]
|
|
174
|
-
}
|
|
175
|
-
}
|
|
176
|
-
}
|
|
177
|
-
```
|
|
178
|
-
|
|
179
|
-
## Cursor Setup
|
|
180
|
-
|
|
181
|
-
[Docs](https://docs.cursor.com/context/model-context-protocol)
|
|
182
|
-
|
|
183
|
-
**Via Command Palette**: `Cmd+Shift+P` → "View: Open MCP Settings"
|
|
184
|
-
|
|
185
|
-
**Manual config** - add to `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global):
|
|
186
|
-
|
|
187
|
-
```json
|
|
188
|
-
{
|
|
189
|
-
"mcpServers": {
|
|
190
|
-
"rn-ai-devtools": {
|
|
191
|
-
"command": "npx",
|
|
192
|
-
"args": ["-y", "react-native-ai-devtools"]
|
|
193
|
-
}
|
|
194
|
-
}
|
|
195
|
-
}
|
|
196
|
-
```
|
|
197
|
-
|
|
198
205
|
## Claude Code Skills
|
|
199
206
|
|
|
200
207
|
Pre-built skills for common debugging workflows — session setup, log inspection, network debugging, and more. See the [skills guide](docs/skills.md) for the full list and installation instructions.
|