Overview

Configure MCP (CLI optional)

If you prefer not to use the CLI, configure an MCP server in Cursor (or similar AI IDEs). The IDEA plugin exposes preview, run, screenshot, OCR, node capture, and more.

Prerequisite: IntelliJ IDEA is running with an EasyClick project open (plugin loaded).

Add this to Cursor MCP config (e.g. user mcp.json):

1
{
2
  "mcpServers": {
3
    "easyclick-ios": {
4
      "url": "http://127.0.0.1:18562/mcp"
5
    }
6
  }
7
}

Default URL: http://127.0.0.1:18562/mcp. If the port is busy, the plugin tries subsequent ports starting from 18562.

Project layout

Open a folder in IDEA, then New Module:
If ec_work_config/ios/bin is missing, close and reopen the project folder
ec_work_config/ios/bin holds EC iOS build CLI and SKILL.md

Coding with Cursor

Open project

In Cursor, open the project folder, not a single module
Ask the AI to understand the project and scan structure + SKILL.md

Build IEC

Ask the AI to build, e.g. module testai

Preview project

Requires a device connected in IDEA
Ask the AI to preview, e.g. testai
iOS USB projects can’t preview — only standalone iOS can

Run project

Requires a device in IDEA
Ask the AI to run, e.g. testai
After the AI writes logic, run and verify

Feed docs to the AI

In chat, type @, choose Docs → Add new doc, add EC doc URLs for the AI to fetch

Auto-coding and log analysis — explore yourself; CLI commands describe what happened so the AI can act

CLI commands — SKILL.md

The SKILL.md below is for the AI to ingest — you can skip reading it

1
---
2
name: ec-ios-cli
3
description: >-
4
 EasyClick ec-ios-cli install prerequisites, subcommands, flags, and examples.
5
 Use when a user or Agent needs to run, script, or troubleshoot this CLI; no implementation internals.
6
---
7

8
# ec-ios-cli reference
9

10
## Prerequisites
11
- Replaces some IDEA plugin actions; for EasyClick **iOS USB** and **standalone** editions only.
12
- **IntelliJ IDEA** running with **EasyClick iOS dev tools** plugin responsive.
13
- **Module name** in CLI matches the IDEA script module name.
14
- Multiple windows/projects: use **`-p` / `--project`** with the **project root** path as opened in IDEA.
15

16
## Binary and help
17
- **Bundled binary** (repo root): **`ec_work_config/ios/bin/ec-ios-cli`**
18
 - From repo root: `./ec_work_config/ios/bin/ec-ios-cli -h`
19
 - Agents/scripts should prefer this path over global PATH.
20
- If installed globally: **`ec-ios-cli`** (same program; rename locally if needed).
21
- Help: `./ec_work_config/ios/bin/ec-ios-cli -h`
22
- Subcommand help: `./ec_work_config/ios/bin/ec-ios-cli <subcommand> -h`
23

24
## Subcommands
25

26
| Subcommand | Purpose |
27
|--------|------|
28
| `preview` | Preview project |
29
| `run` | Run project |
30
| `stop` | Stop running script |
31
| `build` | Build IEC |
32
| `monitor` | Stream logs only (no `-m`) |
33
| `capture-image` | Screenshot path (AI assist) |
34
| `ocr-screen` | OCR current screen (AI assist) |
35
| `capture-node` | Capture UIX nodes path (AI assist) |
36
| `test-image` | Template match test (AI assist) |
37
| `ocr-local-image` | OCR local image (AI assist) |
38

39
**Notes:**
40
- `preview / run / stop / build / capture-image / ocr-screen / capture-node / test-image / ocr-local-image` need **`-m` (module)**.
41
- `monitor` has no module.
42
- `capture-image` aliases: `captureImage` / `fetch-image` / `fetchImage` (prefer `capture-image`).
43

44
## Common flags (except `monitor`)
45

46
| Flag | Meaning |
47
|------|------|
48
| **`-m` / `--module`** | **Required.** IDEA module name. |
49
| **`-p` / `--project`** | Optional. Project root (IDEA path). |
50
| **`-f` / `--format`** | Optional. Log format: `text` or `json`; default **`json`**. |
51
| **`-o` / `--log`** | Optional. Append logs to file. |
52
| **`-k` / `--stop-on`** | Optional. Exit when log contains substring; **`|||`** = OR. |
53
| **`-w` / `--monitor-logs`** | Optional. `true`/`false`. Default monitors; `-w false` ends after HTTP. |
54
| **`-r` / `--random-log`** | Optional. Random log file under `ai_logs/`; **not with `-o`**. |
55

56
**Constraints:**
57
- Optional flags need valid values.
58
- **`-r` and `-o` are mutually exclusive.**
59

60
## Boolean flags — use `=`
61

62
Bool flags like `--need-auto` / `--release` / `--monitor-logs`:
63
- `--flag` = **true**
64
- For **false**, use **`--flag=false`** (or `-a=false`)
65

66
Examples:
67
- `--need-auto` = `--need-auto=true`
68
- `--need-auto=false` explicitly disables
69

70
## `monitor` only
71

72
| Flag | Meaning |
73
|------|------|
74
| **`-f` / `--format`** | `text` or `json`, default `json`. |
75
| **`-o` / `--log`** | Append to file. |
76
| **`-k` / `--stop-on`** | Exit on match (`|||` OR). |
77
| **`-r` / `--random-log`** | Random log file (not with `-o`). |
78

79
## AI assist commands
80

81
Support `-m/-p/-f/-o/-r/-k/-w`; default `stop-on` includes `失败请登录` (login failure).
82

83
### `capture-image`
84
- **`--dir / -d`**: save dir (default project image dir)
85
- **`--image-format / -g`**: `jpg|png` (default `jpg`)
86
- **`--need-auto / -a`**: need automation service (default `true`)
87

88
EC=./ec_work_config/ios/bin/ec-ios-cli
89
$EC capture-image -m app
90
$EC capture-image -m app -d /tmp -g png
91
$EC capture-image -m app --need-auto=false
92

93
### `ocr-screen`
94
- **`--ocr-type / -t`**: default `paddleOcrNcnnV5`
95
- **`--padding / -x`**: default `32`
96
- **`--max-side-len / -l`**: default `640`
97
- **`--release / -e`**: default `false`
98
- **`--need-auto / -a`**: default `true`
99

100
EC=./ec_work_config/ios/bin/ec-ios-cli
101
$EC ocr-screen -m app
102
$EC ocr-screen -m app -t paddleOcrOnnxV5 -x 32 -l 640
103

104
### `capture-node`
105
- **`--dir / -d`**: save dir (default node dir)
106

107
EC=./ec_work_config/ios/bin/ec-ios-cli
108
$EC capture-node -m app
109
$EC capture-node -m app -d /tmp
110

111
### `test-image`
112
- **`--test-type / -t`**: `2` (live, default) or `1` (local image)
113
- **`--small-image-path / -s`**: required template path
114
- **`--big-image-path / -b`**: required for `-t 1`
115

116
EC=./ec_work_config/ios/bin/ec-ios-cli
117
# Live (default)
118
$EC test-image -m app -s /path/to/small.png
119
# Local image
120
$EC test-image -m app -t 1 -s /path/to/small.png -b /path/to/big.png
121

122
### `ocr-local-image`
123
- **`--path / -i`**: required image path
124
- Other flags same as `ocr-screen`
125

126
EC=./ec_work_config/ios/bin/ec-ios-cli
127
$EC ocr-local-image -m app -i /path/to/image.png
128
$EC ocr-local-image -m app -i /path/to/image.png -t paddleOcrOnnxV5 -x 32 -l 640
129

130
## Logging
131
- Most logs on **stderr**; **`-o`** / **`-r`** also write files.
132
- Default format **JSON** unless **`-f text`**.
133

134
## Classic examples (preview / run / stop / build / monitor)
135

136
# From repo root; EC = ./ec_work_config/ios/bin/ec-ios-cli
137
EC=./ec_work_config/ios/bin/ec-ios-cli
138

139
# preview
140
$EC preview -m app
141
$EC preview -m app -f json
142

143
# run
144
$EC run -m app
145
$EC run -m app -f json -o /tmp/easyclick.log
146
$EC run -m app -r true
147
$EC run -m app -w false
148

149
# stop
150
$EC stop -m app
151

152
# build (IEC)
153
$EC build -m app
154

155
# monitor (logs only)
156
$EC monitor
157
$EC monitor -f text -o /tmp/monitor.log -k "完成"
158

159
Multi-project / multi-IDEA (use `-p`):
160

161
./ec_work_config/ios/bin/ec-ios-cli run -m app -p /path/to/project/root
162

163
## Combined examples
164

165
EC=./ec_work_config/ios/bin/ec-ios-cli
166

167
# Legacy
168
$EC preview -m app
169
$EC run -m app -o /tmp/run.log -k "上传"
170
$EC stop -m app
171
$EC build -m app
172
$EC monitor -k "完成"
173

174
# AI assist
175
$EC capture-image -m app -d /tmp -g png
176
$EC ocr-screen -m app
177
$EC capture-node -m app
178
$EC test-image -m app -s /path/to/small.png
179
$EC ocr-local-image -m app -i /path/to/image.png