chrome-cdp-cli 1.7.0 → 1.7.2

package/dist/handlers/InstallCursorCommandHandler.js

@@ -126,148 +126,148 @@ Examples:
         return [
             {
                 name: 'cdp-cli',
-                description: 'Chrome DevTools Protocol CLI 工具',
-                instructions: `通过 Chrome DevTools Protocol 控制 Chrome 浏览器，支持完整的自动化操作。
+                description: 'Chrome DevTools Protocol CLI Tool',
+                instructions: `Control Chrome browser through Chrome DevTools Protocol, supporting complete automation operations.
 
-## 完整命令列表
+## Complete Command List
 
-### 1. JavaScript 执行
-- **eval** - 执行 JavaScript 代码并返回结果，支持异步代码和 Promise
+### 1. JavaScript Execution
+- **eval** - Execute JavaScript code and return results, supports async code and Promises
   \`chrome-cdp-cli eval "document.title"\`
   \`chrome-cdp-cli eval "fetch('/api/data').then(r => r.json())"\`
 
-### 2. 页面截图和快照
-- **screenshot** - 捕获页面截图并保存到文件
+### 2. Page Screenshots and Snapshots
+- **screenshot** - Capture page screenshot and save to file
   \`chrome-cdp-cli screenshot --filename page.png\`
   \`chrome-cdp-cli screenshot --filename fullpage.png --full-page\`
 
-- **snapshot** - 捕获完整 DOM 快照（包含结构、样式、布局）
+- **snapshot** - Capture complete DOM snapshot (including structure, styles, layout)
   \`chrome-cdp-cli snapshot --filename dom-snapshot.json\`
 
-### 3. 元素交互
-- **click** - 点击页面元素
+### 3. Element Interaction
+- **click** - Click page elements
   \`chrome-cdp-cli click "#submit-button"\`
   \`chrome-cdp-cli click ".menu-item" --timeout 10000\`
 
-- **hover** - 鼠标悬停在元素上
+- **hover** - Mouse hover over elements
   \`chrome-cdp-cli hover "#dropdown-trigger"\`
 
-- **fill** - 填充表单字段
+- **fill** - Fill form fields
   \`chrome-cdp-cli fill "#username" "john@example.com"\`
   \`chrome-cdp-cli fill "input[name='password']" "secret123"\`
 
-- **fill_form** - 批量填充表单
+- **fill_form** - Batch fill forms
   \`chrome-cdp-cli fill_form '{"#username": "john", "#password": "secret"}'\`
 
-### 4. 高级交互
-- **drag** - 拖拽操作
+### 4. Advanced Interactions
+- **drag** - Drag and drop operations
   \`chrome-cdp-cli drag "#draggable" "#dropzone"\`
 
-- **press_key** - 模拟键盘输入
+- **press_key** - Simulate keyboard input
   \`chrome-cdp-cli press_key "Enter"\`
   \`chrome-cdp-cli press_key "a" --modifiers Ctrl --selector "#input"\`
 
-- **upload_file** - 文件上传
+- **upload_file** - File upload
   \`chrome-cdp-cli upload_file "input[type='file']" "./document.pdf"\`
 
-- **wait_for** - 等待元素出现或满足条件
+- **wait_for** - Wait for elements to appear or meet conditions
   \`chrome-cdp-cli wait_for "#loading" --condition hidden\`
   \`chrome-cdp-cli wait_for "#submit-btn" --condition enabled\`
 
-- **handle_dialog** - 处理浏览器对话框
+- **handle_dialog** - Handle browser dialogs
   \`chrome-cdp-cli handle_dialog accept\`
   \`chrome-cdp-cli handle_dialog accept --text "user input"\`
 
-### 5. 监控功能
-- **get_console_message** - 获取最新控制台消息
+### 5. Monitoring Features
+- **get_console_message** - Get latest console message
   \`chrome-cdp-cli get_console_message\`
 
-- **list_console_messages** - 列出所有控制台消息
+- **list_console_messages** - List all console messages
   \`chrome-cdp-cli list_console_messages --type error\`
 
-- **get_network_request** - 获取最新网络请求
+- **get_network_request** - Get latest network request
   \`chrome-cdp-cli get_network_request\`
 
-- **list_network_requests** - 列出所有网络请求
+- **list_network_requests** - List all network requests
   \`chrome-cdp-cli list_network_requests --method POST\`
 
-### 6. IDE 集成
-- **install_cursor_command** - 安装 Cursor 命令
+### 6. IDE Integration
+- **install_cursor_command** - Install Cursor commands
   \`chrome-cdp-cli install_cursor_command\`
 
-- **install_claude_skill** - 安装 Claude 技能
+- **install_claude_skill** - Install Claude skills
   \`chrome-cdp-cli install_claude_skill --skill-type personal\`
 
-## 常用工作流程
+## Common Workflows
 
-### 完整的表单测试流程
+### Complete Form Testing Workflow
 \`\`\`bash
-# 1. 等待页面加载
+# 1. Wait for page to load
 chrome-cdp-cli wait_for "#login-form" --condition visible
 
-# 2. 填写表单
+# 2. Fill form
 chrome-cdp-cli fill "#email" "test@example.com"
 chrome-cdp-cli fill "#password" "password123"
 
-# 3. 提交表单
+# 3. Submit form
 chrome-cdp-cli click "#submit-button"
 
-# 4. 等待结果并截图
+# 4. Wait for result and take screenshot
 chrome-cdp-cli wait_for "#success-message" --condition visible
 chrome-cdp-cli screenshot --filename login-success.png
 
-# 5. 检查控制台错误
+# 5. Check console errors
 chrome-cdp-cli list_console_messages --type error
 \`\`\`
 
-### 文件上传测试
+### File Upload Testing
 \`\`\`bash
-# 1. 点击上传按钮
+# 1. Click upload button
 chrome-cdp-cli click "#upload-trigger"
 
-# 2. 上传文件
+# 2. Upload file
 chrome-cdp-cli upload_file "input[type='file']" "./test-document.pdf"
 
-# 3. 等待上传完成
+# 3. Wait for upload completion
 chrome-cdp-cli wait_for ".upload-success" --condition visible
 
-# 4. 验证结果
+# 4. Verify result
 chrome-cdp-cli eval "document.querySelector('.file-name').textContent"
 \`\`\`
 
-### 拖拽交互测试
+### Drag and Drop Interaction Testing
 \`\`\`bash
-# 1. 等待元素可用
+# 1. Wait for elements to be available
 chrome-cdp-cli wait_for "#draggable-item" --condition visible
 chrome-cdp-cli wait_for "#drop-zone" --condition visible
 
-# 2. 执行拖拽
+# 2. Perform drag and drop
 chrome-cdp-cli drag "#draggable-item" "#drop-zone"
 
-# 3. 验证拖拽结果
+# 3. Verify drag result
 chrome-cdp-cli eval "document.querySelector('#drop-zone').children.length"
 \`\`\`
 
-### 键盘导航测试
+### Keyboard Navigation Testing
 \`\`\`bash
-# 1. 聚焦到输入框
+# 1. Focus on input field
 chrome-cdp-cli click "#search-input"
 
-# 2. 输入文本
+# 2. Type text
 chrome-cdp-cli press_key "t"
 chrome-cdp-cli press_key "e"
 chrome-cdp-cli press_key "s"
 chrome-cdp-cli press_key "t"
 
-# 3. 使用快捷键
-chrome-cdp-cli press_key "a" --modifiers Ctrl  # 全选
-chrome-cdp-cli press_key "Enter"  # 提交
+# 3. Use keyboard shortcuts
+chrome-cdp-cli press_key "a" --modifiers Ctrl  # Select all
+chrome-cdp-cli press_key "Enter"  # Submit
 
-# 4. 处理可能的确认对话框
+# 4. Handle possible confirmation dialog
 chrome-cdp-cli handle_dialog accept
 \`\`\`
 
-命令会自动连接到运行在 localhost:9222 的 Chrome 实例。`,
+Commands automatically connect to Chrome instance running on localhost:9222.`,
                 examples: [
                     'chrome-cdp-cli eval "document.title"',
                     'chrome-cdp-cli screenshot --filename page.png',
@@ -290,74 +290,74 @@ chrome-cdp-cli handle_dialog accept
 
 ${command.instructions}
 
-## 使用示例
+## Usage Examples
 
 ${examples}
 
-## 前置条件
+## Prerequisites
 
-确保 Chrome 浏览器已启动并开启了远程调试：
+Ensure Chrome browser is started with remote debugging enabled:
 
 \`\`\`bash
 chrome --remote-debugging-port=9222
 \`\`\`
 
-或者在 macOS 上：
+Or on macOS:
 
 \`\`\`bash
 /Applications/Google\\ Chrome.app/Contents/MacOS/Google\\ Chrome --remote-debugging-port=9222
 \`\`\`
 
-## 全局选项
+## Global Options
 
-所有命令都支持以下全局选项：
+All commands support the following global options:
 
-- \`--host <hostname>\`: Chrome DevTools 主机地址 (默认: localhost)
-- \`--port <number>\`: Chrome DevTools 端口 (默认: 9222)
-- \`--format <json|text>\`: 输出格式 (默认: json)
-- \`--verbose\`: 启用详细日志
-- \`--quiet\`: 静默模式
-- \`--timeout <ms>\`: 命令超时时间
+- \`--host <hostname>\`: Chrome DevTools host address (default: localhost)
+- \`--port <number>\`: Chrome DevTools port (default: 9222)
+- \`--format <json|text>\`: Output format (default: json)
+- \`--verbose\`: Enable verbose logging
+- \`--quiet\`: Silent mode
+- \`--timeout <ms>\`: Command timeout
 
-## 常用工作流程
+## Common Workflows
 
-### 网页自动化测试
+### Web Automation Testing
 \`\`\`bash
-# 1. 导航到页面并截图
+# 1. Navigate to page and take screenshot
 chrome-cdp-cli eval "window.location.href = 'https://example.com'"
 chrome-cdp-cli screenshot --filename before.png
 
-# 2. 填写表单
+# 2. Fill form
 chrome-cdp-cli eval "document.querySelector('#email').value = 'test@example.com'"
 chrome-cdp-cli eval "document.querySelector('#password').value = 'password123'"
 
-# 3. 提交并检查结果
+# 3. Submit and check results
 chrome-cdp-cli eval "document.querySelector('#submit').click()"
 chrome-cdp-cli screenshot --filename after.png
 chrome-cdp-cli list_console_messages --type error
 \`\`\`
 
-### API 调用监控
+### API Call Monitoring
 \`\`\`bash
-# 1. 开始监控网络请求
+# 1. Start monitoring network requests
 chrome-cdp-cli eval "fetch('/api/users').then(r => r.json())"
 
-# 2. 查看网络请求
+# 2. View network requests
 chrome-cdp-cli list_network_requests --method POST
 
-# 3. 获取最新请求详情
+# 3. Get latest request details
 chrome-cdp-cli get_network_request
 \`\`\`
 
-### 页面分析
+### Page Analysis
 \`\`\`bash
-# 1. 获取页面基本信息
+# 1. Get basic page information
 chrome-cdp-cli eval "({title: document.title, url: location.href, links: document.querySelectorAll('a').length})"
 
-# 2. 捕获完整页面结构
+# 2. Capture complete page structure
 chrome-cdp-cli snapshot --filename page-analysis.json
 
-# 3. 检查控制台错误
+# 3. Check console errors
 chrome-cdp-cli list_console_messages --type error
 \`\`\`
 `;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-cdp-cli",
-  "version": "1.7.0",
+  "version": "1.7.2",
   "description": "LLM-first browser automation CLI via Chrome DevTools Protocol. Eval-first design optimized for AI assistants - LLMs write JavaScript scripts for rapid validation. Features: JavaScript execution, element interaction, screenshots, DOM snapshots, console/network monitoring. Built-in IDE integration for Cursor and Claude.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -34,7 +34,8 @@
     "package": "npm run build:prod && npm pack",
     "prepublishOnly": "npm run test:ci && npm run build:prod",
     "prepack": "npm run build:prod",
-    "verify": "npm run lint && npm run test:ci && npm run build:prod"
+    "verify": "npm run lint && npm run test:ci && npm run build:prod",
+    "postinstall": "node -e \"console.log('\\n🎉 chrome-cdp-cli installed successfully!\\n\\n📋 Quick Start:\\n  1. Start Chrome with debugging: chrome --remote-debugging-port=9222\\n  2. Try: chrome-cdp-cli eval \\\"document.title\\\"\\n  3. Get help: chrome-cdp-cli --help\\n\\n🔗 More info: https://github.com/nicoster/chrome-devtools-cli\\n')\""
   },
   "keywords": [
     "chrome",