diff --git a/browse/SKILL.md b/browse/SKILL.md index ed840e69..9ab4b383 100644 --- a/browse/SKILL.md +++ b/browse/SKILL.md @@ -536,14 +536,14 @@ After `resume`, you get a fresh snapshot of wherever the user left off. The snapshot is your primary tool for understanding and interacting with pages. ``` --i --interactive Interactive elements only (buttons, links, inputs) with @e refs +-i --interactive Interactive elements only (buttons, links, inputs) with @e refs. Also auto-enables cursor-interactive scan (-C) to capture dropdowns and popovers. -c --compact Compact (no empty structural nodes) -d --depth Limit tree depth (0 = root only, default: unlimited) -s --selector Scope to CSS selector -D --diff Unified diff against previous snapshot (first call stores baseline) -a --annotate Annotated screenshot with red overlay boxes and ref labels -o --output Output path for annotated screenshot (default: /browse-annotated.png) --C --cursor-interactive Cursor-interactive elements (@c refs — divs with pointer, onclick) +-C --cursor-interactive Cursor-interactive elements (@c refs — divs with pointer, onclick). Auto-enabled when -i is used. ``` All flags can be combined freely. `-o` only applies when `-a` is also used. diff --git a/browse/src/snapshot.ts b/browse/src/snapshot.ts index 5581fe6e..ae18c3f3 100644 --- a/browse/src/snapshot.ts +++ b/browse/src/snapshot.ts @@ -56,14 +56,14 @@ export const SNAPSHOT_FLAGS: Array<{ valueHint?: string; optionKey: keyof SnapshotOptions; }> = [ - { short: '-i', long: '--interactive', description: 'Interactive elements only (buttons, links, inputs) with @e refs', optionKey: 'interactive' }, + { short: '-i', long: '--interactive', description: 'Interactive elements only (buttons, links, inputs) with @e refs. Also auto-enables cursor-interactive scan (-C) to capture dropdowns and popovers.', optionKey: 'interactive' }, { short: '-c', long: '--compact', description: 'Compact (no empty structural nodes)', optionKey: 'compact' }, { short: '-d', long: '--depth', description: 'Limit tree depth (0 = root only, default: unlimited)', takesValue: true, valueHint: '', optionKey: 'depth' }, { short: '-s', long: '--selector', description: 'Scope to CSS selector', takesValue: true, valueHint: '', optionKey: 'selector' }, { short: '-D', long: '--diff', description: 'Unified diff against previous snapshot (first call stores baseline)', optionKey: 'diff' }, { short: '-a', long: '--annotate', description: 'Annotated screenshot with red overlay boxes and ref labels', optionKey: 'annotate' }, { short: '-o', long: '--output', description: 'Output path for annotated screenshot (default: /browse-annotated.png)', takesValue: true, valueHint: '', optionKey: 'outputPath' }, - { short: '-C', long: '--cursor-interactive', description: 'Cursor-interactive elements (@c refs — divs with pointer, onclick)', optionKey: 'cursorInteractive' }, + { short: '-C', long: '--cursor-interactive', description: 'Cursor-interactive elements (@c refs — divs with pointer, onclick). Auto-enabled when -i is used.', optionKey: 'cursorInteractive' }, ]; interface ParsedNode {