@web-auto/camo 0.1.7 → 0.1.9

package/README.md

@@ -5,6 +5,17 @@
 
 A cross-platform command-line interface for Camoufox browser automation.
 
+## What Camo Provides
+
+- Browser lifecycle management: start/stop/list sessions, idle cleanup, lock cleanup.
+- Profile-first automation: persistent profile dirs, fingerprint support, remembered window size.
+- Browser control primitives: navigation, tabs, viewport/window, mouse and keyboard actions.
+- Devtools debugging helpers: open devtools, evaluate JS quickly, collect browser console logs.
+- Session recorder: JSONL interaction capture (click/input/scroll/keyboard + page visits) with runtime toggle.
+- Container subscription layer: selector registration, filter/list/watch in viewport.
+- Autoscript runtime: validate/explain/run/resume/mock-run with snapshot and replay.
+- Progress stream: local websocket daemon (`/events`) with tail/recent/emit commands.
+
 ## Installation
 
 ### npm (Recommended)
@@ -42,13 +53,72 @@ camo start worker-1 --headless --alias shard1 --idle-timeout 30m
 # Start with devtools (headful only)
 camo start worker-1 --devtools
 
+# Evaluate JS (devtools-style input in page context)
+camo devtools eval worker-1 "document.title"
+
+# Read captured console entries
+camo devtools logs worker-1 --levels error,warn --limit 50
+
+# Start recording into JSONL (with in-page toggle)
+camo record start worker-1 --name run-a --output ./logs/run-a.jsonl --overlay
+
 # Navigate
 camo goto https://www.xiaohongshu.com
 
 # Interact
+camo highlight-mode on
+camo click "#search-input" --highlight
+camo type "#search-input" "hello world" --highlight
+camo scroll --down --amount 500 --selector ".feed-list"
+```
+
+## Core Workflows
+
+### 1) Interactive browser session
+
+```bash
+camo init
+camo profile create myprofile
+camo profile default myprofile
+camo start --url https://example.com --alias main
 camo click "#search-input"
 camo type "#search-input" "hello world"
-camo scroll --down --amount 500
+```
+
+### 2) Headless worker with idle auto-stop
+
+```bash
+camo start worker-1 --headless --alias shard1 --idle-timeout 30m
+camo instances
+camo stop idle
+```
+
+### 3) Devtools-style debugging
+
+```bash
+camo start myprofile --devtools
+camo devtools eval myprofile "document.title"
+camo devtools eval myprofile "(console.error('check-error'), location.href)"
+camo devtools logs myprofile --levels error,warn --limit 50
+camo devtools clear myprofile
+```
+
+### 4) Run autoscript with live progress
+
+```bash
+camo autoscript validate ./autoscripts/xhs.autoscript.json
+camo autoscript run ./autoscripts/xhs.autoscript.json --profile myprofile \
+  --jsonl-file ./runs/xhs/run.jsonl \
+  --summary-file ./runs/xhs/summary.json
+camo events tail --profile myprofile --mode autoscript
+```
+
+### 5) Record manual interactions as JSONL
+
+```bash
+camo start myprofile --record --record-name xhs-debug --record-output ./logs/xhs-debug.jsonl --record-overlay
+camo record status myprofile
+camo record stop myprofile
 ```
 
 ## Commands
@@ -71,10 +141,17 @@ camo init list                         # List available OS and regions
 camo create fingerprint --os <os> --region <region>
 ```
 
+### Config
+
+```bash
+camo config repo-root [path]           # Get/set persisted webauto repo root
+camo highlight-mode [status|on|off]    # Global highlight mode for click/type/scroll
+```
+
 ### Browser Control
 
 ```bash
-camo start [profileId] [--url <url>] [--headless] [--devtools] [--alias <name>] [--idle-timeout <duration>] [--width <w> --height <h>]
+camo start [profileId] [--url <url>] [--headless] [--devtools] [--record] [--record-name <name>] [--record-output <path>] [--record-overlay|--no-record-overlay] [--alias <name>] [--idle-timeout <duration>] [--width <w> --height <h>]
 camo stop [profileId]
 camo stop --id <instanceId>
 camo stop --alias <alias>
@@ -89,6 +166,7 @@ If no saved size exists, it defaults to near-fullscreen (full width, slight vert
 Use `--width/--height` to override and update the saved profile size.
 For headless sessions, default idle timeout is `30m` (auto-stop on inactivity). Use `--idle-timeout` (e.g. `45m`, `1800s`, `0`) to customize.
 Use `--devtools` to open browser developer tools in headed mode (cannot be combined with `--headless`).
+Use `--record` to auto-enable JSONL recording at startup; `--record-name`, `--record-output`, and `--record-overlay` customize file naming/output and floating toggle UI.
 
 ### Lifecycle & Cleanup
 
@@ -100,7 +178,6 @@ camo cleanup all                       # Cleanup all active sessions
 camo cleanup locks                     # Cleanup stale lock files
 camo force-stop [profileId]            # Force stop session (for stuck sessions)
 camo lock list                         # List active session locks
-camo recover [profileId]               # Recover orphaned session
 ```
 
 ### Navigation
@@ -114,14 +191,42 @@ camo screenshot [profileId] [--output <file>] [--full]
 ### Interaction
 
 ```bash
-camo scroll [profileId] [--down|--up|--left|--right] [--amount <px>]
-camo click [profileId] <selector>              # Click element by CSS selector
-camo type [profileId] <selector> <text>        # Type text into element
+camo scroll [profileId] [--down|--up|--left|--right] [--amount <px>] [--selector <css>] [--highlight|--no-highlight]
+camo click [profileId] <selector> [--highlight|--no-highlight]  # Click visible element by CSS selector
+camo type [profileId] <selector> <text> [--highlight|--no-highlight]  # Type into visible input element
 camo highlight [profileId] <selector>          # Highlight element (red border, 2s)
 camo clear-highlight [profileId]               # Clear all highlights
 camo viewport [profileId] --width <w> --height <h>
 ```
 
+### Devtools
+
+```bash
+camo devtools logs [profileId] [--limit 120] [--since <unix_ms>] [--levels error,warn] [--clear]
+camo devtools eval [profileId] <expression> [--profile <id>]
+camo devtools clear [profileId]
+```
+
+`devtools logs` reads entries from an injected in-page console collector.
+Supported levels: `log`, `info`, `warn`, `error`, `debug`.
+
+### Recording
+
+```bash
+camo record start [profileId] [--name <name>] [--output <file>] [--overlay|--no-overlay]
+camo record stop [profileId] [--reason <text>]
+camo record status [profileId]
+```
+
+Recorder JSONL events include:
+- `page.visit`
+- `interaction.click`
+- `interaction.keydown`
+- `interaction.input`
+- `interaction.wheel`
+- `interaction.scroll`
+- `recording.start|stop|toggled|runtime_ready`
+
 ### Pages
 
 ```bash
@@ -339,6 +444,7 @@ Condition types:
 - `WEBAUTO_CONTAINER_ROOT` - User container root override (default: `~/.webauto/container-lib`)
 - `CAMO_PROGRESS_EVENTS_FILE` - Optional progress event JSONL path override
 - `CAMO_PROGRESS_WS_HOST` / `CAMO_PROGRESS_WS_PORT` - Progress websocket daemon bind address (default: `127.0.0.1:7788`)
+- `CAMO_DEFAULT_WINDOW_VERTICAL_RESERVE` - Reserved vertical pixels for default headful auto-size
 
 ## Session Persistence
 
@@ -346,7 +452,6 @@ Camo CLI persists session information locally:
 
 - Sessions are registered in `~/.webauto/sessions/`
 - On restart, `camo sessions` / `camo instances` shows live + orphaned sessions
-- Use `camo recover <profileId>` to reconnect or cleanup orphaned sessions
 - Stale sessions (>7 days) are automatically cleaned up
 
 ## Requirements

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@web-auto/camo",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Camoufox Browser CLI - Cross-platform browser automation",
   "type": "module",
   "bin": {
@@ -18,6 +18,7 @@
     "check:file-size": "node scripts/check-file-size.mjs",
     "test": "node --test 'tests/**/*.test.mjs'",
     "test:coverage": "c8 --reporter=text --reporter=lcov node --test 'tests/**/*.test.mjs'",
+    "test:coverage:modes": "c8 --all --check-coverage --lines 90 --functions 90 --branches 90 --statements 90 --include src/commands/record.mjs --include src/commands/highlight-mode.mjs --include src/container/runtime-core/operations/selector-scripts.mjs node --test tests/unit/commands/record.test.mjs tests/unit/commands/highlight-mode.test.mjs tests/unit/container/selector-scripts.test.mjs tests/unit/commands/browser.test.mjs",
     "version:bump": "node scripts/bump-version.mjs",
     "install:global": "npm run build && npm install -g .",
     "uninstall:global": "npm uninstall -g @web-auto/camo",

package/src/autoscript/action-providers/xhs/comments.mjs

@@ -86,43 +86,6 @@ export function buildCommentsHarvestScript(params = {}) {
       }
       return null;
     };
-    const normalizeInlineText = (value) => String(value || '').replace(/\\s+/g, ' ').trim();
-    const sanitizeAuthorText = (raw, commentText = '') => {
-      const text = normalizeInlineText(raw);
-      if (!text) return '';
-      if (commentText && text === commentText) return '';
-      if (text.length > 40) return '';
-      if (/^(回复|展开|收起|查看更多|评论|赞|分享|发送)$/.test(text)) return '';
-      return text;
-    };
-    const readAuthor = (item, commentText = '') => {
-      const attrNames = ['data-user-name', 'data-username', 'data-user_nickname', 'data-nickname'];
-      for (const attr of attrNames) {
-        const value = sanitizeAuthorText(item.getAttribute?.(attr), commentText);
-        if (value) return value;
-      }
-      const selectors = [
-        '.comment-user .name',
-        '.comment-user .username',
-        '.comment-user .user-name',
-        '.author .name',
-        '.author',
-        '.user-name',
-        '.username',
-        '.name',
-        'a[href*="/user/profile/"]',
-        'a[href*="/user/"]',
-      ];
-      for (const selector of selectors) {
-        const node = item.querySelector(selector);
-        if (!node) continue;
-        const title = sanitizeAuthorText(node.getAttribute?.('title'), commentText);
-        if (title) return title;
-        const text = sanitizeAuthorText(node.textContent, commentText);
-        if (text) return text;
-      }
-      return '';
-    };
 
     const scroller = document.querySelector('.note-scroller')
       || document.querySelector('.comments-el')
@@ -142,8 +105,9 @@ export function buildCommentsHarvestScript(params = {}) {
       const nodes = Array.from(document.querySelectorAll('.comment-item, [class*="comment-item"]'));
       for (const item of nodes) {
         const textNode = item.querySelector('.content, .comment-content, p');
+        const authorNode = item.querySelector('.name, .author, .user-name, [class*="author"], [class*="name"]');
         const text = String((textNode && textNode.textContent) || '').trim();
-        const author = readAuthor(item, text);
+        const author = String((authorNode && authorNode.textContent) || '').trim();
         if (!text) continue;
         const key = author + '::' + text;
         if (commentMap.has(key)) continue;

package/src/autoscript/action-providers/xhs/interaction.mjs

@@ -74,42 +74,6 @@ function buildCollectLikeTargetsScript() {
       }
       return '';
     };
-    const sanitizeUserName = (raw, commentText = '') => {
-      const text = String(raw || '').replace(/\\s+/g, ' ').trim();
-      if (!text) return '';
-      if (commentText && text === commentText) return '';
-      if (text.length > 40) return '';
-      if (/^(回复|展开|收起|查看更多|评论|赞|分享|发送)$/.test(text)) return '';
-      return text;
-    };
-    const readUserName = (item, commentText = '') => {
-      const attrNames = ['data-user-name', 'data-username', 'data-user_nickname', 'data-nickname'];
-      for (const attr of attrNames) {
-        const value = sanitizeUserName(item.getAttribute?.(attr), commentText);
-        if (value) return value;
-      }
-      const selectors = [
-        '.comment-user .name',
-        '.comment-user .username',
-        '.comment-user .user-name',
-        '.author .name',
-        '.author',
-        '.user-name',
-        '.username',
-        '.name',
-        'a[href*="/user/profile/"]',
-        'a[href*="/user/"]',
-      ];
-      for (const selector of selectors) {
-        const node = item.querySelector(selector);
-        if (!node) continue;
-        const title = sanitizeUserName(node.getAttribute?.('title'), commentText);
-        if (title) return title;
-        const text = sanitizeUserName(node.textContent, commentText);
-        if (text) return text;
-      }
-      return '';
-    };
     const readAttr = (item, attrNames) => {
       for (const attr of attrNames) {
         const value = String(item.getAttribute?.(attr) || '').trim();
@@ -117,15 +81,6 @@ function buildCollectLikeTargetsScript() {
       }
       return '';
     };
-    const readUserId = (item) => {
-      const value = readAttr(item, ['data-user-id', 'data-userid', 'data-user_id']);
-      if (value) return value;
-      const anchor = item.querySelector('a[href*="/user/profile/"], a[href*="/user/"]');
-      const href = String(anchor?.getAttribute?.('href') || '').trim();
-      if (!href) return '';
-      const matched = href.match(/\\/user\\/(?:profile\\/)?([a-zA-Z0-9_-]+)/);
-      return matched && matched[1] ? matched[1] : '';
-    };
 
     const matchedSet = new Set(
       Array.isArray(state.matchedComments)
@@ -137,8 +92,8 @@ function buildCollectLikeTargetsScript() {
       const item = items[index];
       const text = readText(item, ['.content', '.comment-content', 'p']);
       if (!text) continue;
-      const userName = readUserName(item, text);
-      const userId = readUserId(item);
+      const userName = readText(item, ['.name', '.author', '.user-name', '.username', '[class*="author"]', '[class*="name"]']);
+      const userId = readAttr(item, ['data-user-id', 'data-userid', 'data-user_id']);
       const timestamp = readText(item, ['.date', '.time', '.timestamp', '[class*="time"]']);
       const likeControl = findLikeControl(item);
       rows.push({

package/src/cli.mjs

@@ -13,6 +13,9 @@ import { handleSystemCommand } from './commands/system.mjs';
 import { handleContainerCommand } from './commands/container.mjs';
 import { handleAutoscriptCommand } from './commands/autoscript.mjs';
 import { handleEventsCommand } from './commands/events.mjs';
+import { handleDevtoolsCommand } from './commands/devtools.mjs';
+import { handleRecordCommand } from './commands/record.mjs';
+import { handleHighlightModeCommand } from './commands/highlight-mode.mjs';
 import {
   handleStartCommand, handleStopCommand, handleStatusCommand,
   handleGotoCommand, handleBackCommand, handleScreenshotCommand,
@@ -64,6 +67,30 @@ function inferProfileId(cmd, args) {
     return positionals[0] || null;
   }
 
+  if (cmd === 'devtools') {
+    const sub = positionals[0] || null;
+    if (sub === 'eval' || sub === 'logs' || sub === 'clear') {
+      return positionals[1] || null;
+    }
+  }
+
+  if (cmd === 'record') {
+    const explicit = readFlagValue(args, ['--profile', '-p']);
+    if (explicit) return explicit;
+    const sub = positionals[0] || null;
+    const values = [];
+    for (let i = 2; i < args.length; i += 1) {
+      const token = args[i];
+      if (!token || String(token).startsWith('-')) continue;
+      const prev = args[i - 1];
+      if (prev && ['--name', '--output', '--reason'].includes(prev)) continue;
+      values.push(String(token));
+    }
+    if (sub === 'start' || sub === 'stop' || sub === 'status') {
+      return values[0] || null;
+    }
+  }
+
   if (cmd === 'autoscript' && positionals[0] === 'run') {
     return explicitProfile || null;
   }
@@ -192,6 +219,21 @@ async function main() {
     return;
   }
 
+  if (cmd === 'devtools') {
+    await runTrackedCommand(cmd, args, () => handleDevtoolsCommand(args));
+    return;
+  }
+
+  if (cmd === 'record') {
+    await runTrackedCommand(cmd, args, () => handleRecordCommand(args));
+    return;
+  }
+
+  if (cmd === 'highlight-mode') {
+    await runTrackedCommand(cmd, args, () => handleHighlightModeCommand(args));
+    return;
+  }
+
   // Lifecycle commands
   if (cmd === 'cleanup') {
     await runTrackedCommand(cmd, args, () => handleCleanupCommand(args));
@@ -237,7 +279,7 @@ async function main() {
     'start', 'stop', 'close', 'status', 'list', 'goto', 'navigate', 'back', 'screenshot',
     'new-page', 'close-page', 'switch-page', 'list-pages', 'shutdown',
     'scroll', 'click', 'type', 'highlight', 'clear-highlight', 'viewport',
-    'cookies', 'window', 'mouse', 'system', 'container', 'autoscript', 'events',
+    'cookies', 'window', 'mouse', 'system', 'container', 'autoscript', 'events', 'devtools', 'record', 'highlight-mode',
   ]);
 
   if (!serviceCommands.has(cmd)) {
@@ -312,6 +354,12 @@ async function main() {
       case 'system':
         await handleSystemCommand(args);
         break;
+      case 'record':
+        await handleRecordCommand(args);
+        break;
+      case 'highlight-mode':
+        await handleHighlightModeCommand(args);
+        break;
     }
   });
 }

package/src/commands/browser.mjs

@@ -1,7 +1,9 @@
 import fs from 'node:fs';
+import path from 'node:path';
 import {
   listProfiles,
   getDefaultProfile,
+  getHighlightMode,
   getProfileWindowSize,
   setProfileWindowSize,
 } from '../utils/config.mjs';
@@ -10,6 +12,7 @@ import { resolveProfileId, ensureUrlScheme, looksLikeUrlToken, getPositionals }
 import { acquireLock, releaseLock, cleanupStaleLocks } from '../lifecycle/lock.mjs';
 import {
   buildSelectorClickScript,
+  buildScrollTargetScript,
   buildSelectorTypeScript,
 } from '../container/runtime-core/operations/selector-scripts.mjs';
 import {
@@ -83,6 +86,12 @@ function validateAlias(alias) {
   return text.slice(0, 64);
 }
 
+function resolveHighlightEnabled(args) {
+  if (args.includes('--highlight')) return true;
+  if (args.includes('--no-highlight')) return false;
+  return getHighlightMode();
+}
+
 function formatDurationMs(ms) {
   const value = Number(ms);
   if (!Number.isFinite(value) || value <= 0) return 'disabled';
@@ -319,12 +328,27 @@ export async function handleStartCommand(args) {
   const idleTimeoutRaw = readFlagValue(args, ['--idle-timeout']);
   const parsedIdleTimeoutMs = parseDurationMs(idleTimeoutRaw, DEFAULT_HEADLESS_IDLE_TIMEOUT_MS);
   const wantsDevtools = args.includes('--devtools');
+  const wantsRecord = args.includes('--record');
+  const recordName = readFlagValue(args, ['--record-name']);
+  const recordOutputRaw = readFlagValue(args, ['--record-output']);
+  const recordOverlay = args.includes('--no-record-overlay')
+    ? false
+    : args.includes('--record-overlay')
+      ? true
+      : null;
   if (hasExplicitWidth !== hasExplicitHeight) {
-    throw new Error('Usage: camo start [profileId] [--url <url>] [--headless] [--devtools] [--alias <name>] [--idle-timeout <duration>] [--width <w> --height <h>]');
+    throw new Error('Usage: camo start [profileId] [--url <url>] [--headless] [--devtools] [--record] [--record-name <name>] [--record-output <path>] [--record-overlay|--no-record-overlay] [--alias <name>] [--idle-timeout <duration>] [--width <w> --height <h>]');
   }
   if ((hasExplicitWidth && explicitWidth < START_WINDOW_MIN_WIDTH) || (hasExplicitHeight && explicitHeight < START_WINDOW_MIN_HEIGHT)) {
     throw new Error(`Window size too small. Minimum is ${START_WINDOW_MIN_WIDTH}x${START_WINDOW_MIN_HEIGHT}`);
   }
+  if (args.includes('--record-name') && !recordName) {
+    throw new Error('Usage: camo start [profileId] --record-name <name>');
+  }
+  if (args.includes('--record-output') && !recordOutputRaw) {
+    throw new Error('Usage: camo start [profileId] --record-output <path>');
+  }
+  const recordOutput = recordOutputRaw ? path.resolve(recordOutputRaw) : null;
   const hasExplicitWindowSize = hasExplicitWidth && hasExplicitHeight;
   const profileSet = new Set(listProfiles());
   let implicitUrl;
@@ -334,8 +358,9 @@ export async function handleStartCommand(args) {
     const arg = args[i];
     if (arg === '--url') { i++; continue; }
     if (arg === '--width' || arg === '--height') { i++; continue; }
-    if (arg === '--alias' || arg === '--idle-timeout') { i++; continue; }
+    if (arg === '--alias' || arg === '--idle-timeout' || arg === '--record-name' || arg === '--record-output') { i++; continue; }
     if (arg === '--headless') continue;
+    if (arg === '--record' || arg === '--record-overlay' || arg === '--no-record-overlay') continue;
     if (arg.startsWith('--')) continue;
 
     if (looksLikeUrlToken(arg) && !profileSet.has(arg)) {
@@ -398,6 +423,14 @@ export async function handleStartCommand(args) {
     if (!existingHeadless && wantsDevtools) {
       payload.devtools = await requestDevtoolsOpen(profileId);
     }
+    if (wantsRecord) {
+      payload.recording = await callAPI('record:start', {
+        profileId,
+        ...(recordName ? { name: recordName } : {}),
+        ...(recordOutput ? { outputPath: recordOutput } : {}),
+        ...(recordOverlay !== null ? { overlay: recordOverlay } : {}),
+      });
+    }
     console.log(JSON.stringify(payload, null, 2));
     startSessionWatchdog(profileId);
     return;
@@ -423,6 +456,10 @@ export async function handleStartCommand(args) {
     url: targetUrl ? ensureUrlScheme(targetUrl) : undefined,
     headless,
     devtools: wantsDevtools,
+    ...(wantsRecord ? { record: true } : {}),
+    ...(recordName ? { recordName } : {}),
+    ...(recordOutput ? { recordOutput } : {}),
+    ...(recordOverlay !== null ? { recordOverlay } : {}),
   });
   
   if (result?.ok) {
@@ -729,32 +766,55 @@ export async function handleScrollCommand(args) {
   await ensureBrowserService();
   const directionFlags = new Set(['--up', '--down', '--left', '--right']);
   const isFlag = (arg) => arg?.startsWith('--');
+  const selectorIdx = args.indexOf('--selector');
+  const selector = selectorIdx >= 0 ? String(args[selectorIdx + 1] || '').trim() : null;
+  const highlight = resolveHighlightEnabled(args);
 
   let profileId = null;
   for (let i = 1; i < args.length; i++) {
     const arg = args[i];
     if (directionFlags.has(arg)) continue;
     if (arg === '--amount') { i++; continue; }
+    if (arg === '--selector') { i++; continue; }
+    if (arg === '--highlight' || arg === '--no-highlight') continue;
     if (isFlag(arg)) continue;
     profileId = arg;
     break;
   }
   if (!profileId) profileId = getDefaultProfile();
-  if (!profileId) throw new Error('Usage: camo scroll [profileId] [--down|--up|--left|--right] [--amount <px>]');
+  if (!profileId) throw new Error('Usage: camo scroll [profileId] [--down|--up|--left|--right] [--amount <px>] [--selector <css>] [--highlight|--no-highlight]');
+  if (selectorIdx >= 0 && !selector) {
+    throw new Error('Usage: camo scroll [profileId] --selector <css>');
+  }
 
   const direction = args.includes('--up') ? 'up' : args.includes('--left') ? 'left' : args.includes('--right') ? 'right' : 'down';
   const amountIdx = args.indexOf('--amount');
   const amount = amountIdx >= 0 ? Number(args[amountIdx + 1]) || 300 : 300;
 
+  const target = await callAPI('evaluate', {
+    profileId,
+    script: buildScrollTargetScript({ selector, highlight }),
+  });
+  const centerX = Number(target?.result?.center?.x);
+  const centerY = Number(target?.result?.center?.y);
+  if (Number.isFinite(centerX) && Number.isFinite(centerY)) {
+    await callAPI('mouse:move', { profileId, x: centerX, y: centerY, steps: 2 });
+  }
+
   const deltaX = direction === 'left' ? -amount : direction === 'right' ? amount : 0;
   const deltaY = direction === 'up' ? -amount : direction === 'down' ? amount : 0;
   const result = await callAPI('mouse:wheel', { profileId, deltaX, deltaY });
-  console.log(JSON.stringify(result, null, 2));
+  console.log(JSON.stringify({
+    ...result,
+    scrollTarget: target?.result || null,
+    highlight,
+  }, null, 2));
 }
 
 export async function handleClickCommand(args) {
   await ensureBrowserService();
   const positionals = getPositionals(args);
+  const highlight = resolveHighlightEnabled(args);
   let profileId;
   let selector;
 
@@ -766,12 +826,12 @@ export async function handleClickCommand(args) {
     selector = positionals[1];
   }
 
-  if (!profileId) throw new Error('Usage: camo click [profileId] <selector>');
-  if (!selector) throw new Error('Usage: camo click [profileId] <selector>');
+  if (!profileId) throw new Error('Usage: camo click [profileId] <selector> [--highlight|--no-highlight]');
+  if (!selector) throw new Error('Usage: camo click [profileId] <selector> [--highlight|--no-highlight]');
 
   const result = await callAPI('evaluate', {
     profileId,
-    script: buildSelectorClickScript({ selector, highlight: false }),
+    script: buildSelectorClickScript({ selector, highlight }),
   });
   console.log(JSON.stringify(result, null, 2));
 }
@@ -779,6 +839,7 @@ export async function handleClickCommand(args) {
 export async function handleTypeCommand(args) {
   await ensureBrowserService();
   const positionals = getPositionals(args);
+  const highlight = resolveHighlightEnabled(args);
   let profileId;
   let selector;
   let text;
@@ -793,12 +854,12 @@ export async function handleTypeCommand(args) {
     text = positionals[2];
   }
 
-  if (!profileId) throw new Error('Usage: camo type [profileId] <selector> <text>');
-  if (!selector || text === undefined) throw new Error('Usage: camo type [profileId] <selector> <text>');
+  if (!profileId) throw new Error('Usage: camo type [profileId] <selector> <text> [--highlight|--no-highlight]');
+  if (!selector || text === undefined) throw new Error('Usage: camo type [profileId] <selector> <text> [--highlight|--no-highlight]');
 
   const result = await callAPI('evaluate', {
     profileId,
-    script: buildSelectorTypeScript({ selector, highlight: false, text }),
+    script: buildSelectorTypeScript({ selector, highlight, text }),
   });
   console.log(JSON.stringify(result, null, 2));
 }