@omniaibot/win-x64 0.3.11 → 1.1.2

package/bin/omnibot-windows-x64/omnibot/skills/omnibot/references/command-reference.md

@@ -0,0 +1,616 @@
+# Omnibot Command Reference
+
+This is a lookup table, not a behavior guide. Choose behavior from `operation-patterns.md`, use `session-and-tabs.md` for targeting, and use `fallback-operations.md` before dropping to lower tiers.
+
+## Runtime & Status
+
+### doctor
+
+Purpose: Check daemon and browser extension health.
+
+```bash
+omnibot doctor
+```
+
+Preferred pattern: See `runtime-and-status.md#startup-check`.
+Fallback relation: Not a fallback command.
+
+### status
+
+Purpose: Show daemon status only (lighter than `doctor`).
+
+```bash
+omnibot status
+```
+
+Preferred pattern: See `runtime-and-status.md#daemon-lifecycle`.
+Fallback relation: Not a fallback command.
+
+### start
+
+Purpose: Start the daemon in the background.
+
+```bash
+omnibot start
+```
+
+Equivalent to: `omnibot daemon start`
+
+### stop
+
+Purpose: Stop the running daemon.
+
+```bash
+omnibot stop
+```
+
+Equivalent to: `omnibot daemon stop`
+
+### run
+
+Purpose: Run the daemon in the foreground.
+
+```bash
+omnibot run
+```
+
+Equivalent to: `omnibot daemon run`
+
+### tabs
+
+Purpose: List connected browser tabs and discover tab ids.
+
+```bash
+omnibot tabs
+```
+
+Preferred pattern: See `session-and-tabs.md#tab-explicit`.
+Fallback relation: Not a fallback command.
+
+### license status
+
+Purpose: Check license state.
+
+```bash
+omnibot license status
+```
+
+Preferred pattern: See `runtime-and-status.md#startup-check`.
+Fallback relation: Not a fallback command.
+
+## Reading
+
+### scan
+
+Purpose: Observe the current rendered viewport, especially before choosing a follow-up action.
+
+```bash
+OMNIBOT_SESSION_TOKEN=research omnibot scan --json --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=research omnibot scan --text-only --tab-id <TAB_ID>
+```
+
+Preferred pattern: See `operation-patterns.md#read` and `operation-patterns.md#extraction`.
+Fallback relation: Use before `dom visible` or `execute-js` when structured viewport state is needed. Use `read` instead for long-form page text.
+
+### read
+
+Purpose: Read clean rendered page text/Markdown from an existing tab or a temporary URL tab.
+
+```bash
+OMNIBOT_SESSION_TOKEN=research omnibot read --screens 5 --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=research omnibot read --screens 3 https://example.com/article
+OMNIBOT_SESSION_TOKEN=research omnibot read --json --screens 5 --tab-id <TAB_ID>
+```
+
+Preferred pattern: See `operation-patterns.md#read` and `operation-patterns.md#extraction`.
+Fallback relation: Prefer for page content. Use `scan --json` when the next step is action planning, and `snapshot -i` when actionable refs are needed.
+
+### snapshot -i
+
+Purpose: Read accessibility tree and produce actionable `@eN` refs.
+
+```bash
+OMNIBOT_SESSION_TOKEN=checkout omnibot snapshot -i --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=checkout omnibot snapshot -i -c -d 4 --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=checkout omnibot snapshot -i -s "#main" -u --tab-id <TAB_ID>
+```
+
+Preferred pattern: See `operation-patterns.md#click`, `operation-patterns.md#fill`, and `session-and-tabs.md#ref-scope`.
+Fallback relation: Tier 2 after semantic find.
+
+### get
+
+Purpose: Read one value or element state without dumping the page.
+
+```bash
+OMNIBOT_SESSION_TOKEN=research omnibot get title --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=research omnibot get url --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=research omnibot get text "#main" --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=research omnibot get html "#main" --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=research omnibot get value "input[name=email]" --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=research omnibot get attr "a.login" href --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=research omnibot get count ".item" --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=research omnibot get box "#submit" --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=research omnibot get styles "#submit" --tab-id <TAB_ID>
+```
+
+Preferred pattern: See `operation-patterns.md#read` and `operation-patterns.md#extraction`.
+Fallback relation: Selector tier for reading; escalate only if unavailable.
+
+### is
+
+Purpose: Check element state.
+
+```bash
+OMNIBOT_SESSION_TOKEN=checkout omnibot is visible "#submit" --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=checkout omnibot is enabled "#submit" --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=checkout omnibot is checked "#agree" --tab-id <TAB_ID>
+```
+
+Preferred pattern: See `operation-patterns.md#read` and `operation-patterns.md#select--check`.
+Fallback relation: Prefer before visual or JavaScript checks.
+
+## Actions
+
+### click
+
+Purpose: Click an element by `@eN` ref or selector.
+
+```bash
+OMNIBOT_SESSION_TOKEN=checkout omnibot click --tab-id <TAB_ID> @e4
+OMNIBOT_SESSION_TOKEN=checkout omnibot click --tab-id <TAB_ID> @e4 --new-tab
+OMNIBOT_SESSION_TOKEN=checkout omnibot click "button[type=submit]" --tab-id <TAB_ID>
+```
+
+Preferred pattern: See `operation-patterns.md#click`.
+Fallback relation: Tier 2 with refs, Tier 3 with selector.
+
+### dblclick
+
+Purpose: Double-click an element by `@eN` ref or selector.
+
+```bash
+OMNIBOT_SESSION_TOKEN=editor omnibot dblclick --tab-id <TAB_ID> @e7
+```
+
+Preferred pattern: See `operation-patterns.md#click`.
+Fallback relation: Prefer semantic or snapshot first; then selector.
+
+### fill
+
+Purpose: Replace an input value.
+
+```bash
+OMNIBOT_SESSION_TOKEN=checkout omnibot fill --tab-id <TAB_ID> @e2 "a@b.com"
+OMNIBOT_SESSION_TOKEN=checkout omnibot fill "input[name=email]" "a@b.com" --tab-id <TAB_ID>
+```
+
+Preferred pattern: See `operation-patterns.md#fill`.
+Fallback relation: Tier 2 with refs, Tier 3 with selector.
+
+### type
+
+Purpose: Type text into an element.
+
+```bash
+OMNIBOT_SESSION_TOKEN=search omnibot type --tab-id <TAB_ID> @e3 "omnibot"
+```
+
+Preferred pattern: See `operation-patterns.md#fill`.
+Fallback relation: Use after fill is not appropriate or focus is needed.
+
+### press
+
+Purpose: Press a key in the target tab.
+
+```bash
+OMNIBOT_SESSION_TOKEN=search omnibot press Enter --tab-id <TAB_ID>
+```
+
+Preferred pattern: See `operation-patterns.md#fill` and `operation-patterns.md#wait`.
+Fallback relation: Not a fallback by itself; verify after pressing.
+
+### hover
+
+Purpose: Hover an element by ref or selector.
+
+```bash
+OMNIBOT_SESSION_TOKEN=menu omnibot hover --tab-id <TAB_ID> @e5
+```
+
+Preferred pattern: Observe menu state, hover, then verify visible options.
+Fallback relation: Use mouse move only if hover fails.
+
+### focus
+
+Purpose: Focus an element by selector.
+
+```bash
+OMNIBOT_SESSION_TOKEN=form omnibot focus "input[name=email]" --tab-id <TAB_ID>
+```
+
+Preferred pattern: See `operation-patterns.md#fill`.
+Fallback relation: Selector tier before keyboard/type fallback.
+
+### select
+
+Purpose: Select an option in a dropdown.
+
+```bash
+OMNIBOT_SESSION_TOKEN=form omnibot select @e5 "US" --tab-id <TAB_ID>
+```
+
+Preferred pattern: See `operation-patterns.md#select--check`.
+Fallback relation: Prefer refs/selectors before JavaScript value changes.
+
+### check / uncheck
+
+Purpose: Set checkbox state.
+
+```bash
+OMNIBOT_SESSION_TOKEN=form omnibot check @e6 --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=form omnibot uncheck @e6 --tab-id <TAB_ID>
+```
+
+Preferred pattern: See `operation-patterns.md#select--check`.
+Fallback relation: Verify with `is checked` before and after.
+
+### scroll / scrollintoview
+
+Purpose: Scroll page or element.
+
+```bash
+OMNIBOT_SESSION_TOKEN=read omnibot scroll down 500 --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=read omnibot scroll down 500 --selector "#list" --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=read omnibot scrollintoview @e7 --tab-id <TAB_ID>
+```
+
+Preferred pattern: See `operation-patterns.md#read` and `operation-patterns.md#extraction`.
+Fallback relation: DOM or mouse scroll only after standard scroll fails.
+
+### drag
+
+Purpose: Drag from one element to another.
+
+```bash
+OMNIBOT_SESSION_TOKEN=board omnibot drag @e8 @e9 --tab-id <TAB_ID>
+```
+
+Preferred pattern: Observe source and target, drag, verify position/state.
+Fallback relation: Mouse drag is Tier 5 if element drag fails.
+
+### upload
+
+Purpose: Upload a local file through a file input.
+
+```bash
+OMNIBOT_SESSION_TOKEN=form omnibot upload "input[type=file]" /path/to/file.png --tab-id <TAB_ID>
+```
+
+Preferred pattern: See `operation-patterns.md#upload`.
+Fallback relation: Use JavaScript only if native upload cannot reach the input.
+
+## Semantic Find
+
+Semantic find is Tier 1 for operating by meaning.
+
+```bash
+OMNIBOT_SESSION_TOKEN=checkout omnibot find role button --name "Submit" --action click --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=checkout omnibot find text "Sign in" --action click --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=checkout omnibot find label "Email" --action fill --action-value "a@b.com" --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=checkout omnibot find placeholder "Search" --action type --action-value "omnibot" --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=checkout omnibot find testid submit-button --action click --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=checkout omnibot find nth ".card" 2 --action click --tab-id <TAB_ID>
+```
+
+Preferred pattern: See `operation-patterns.md#click` and `operation-patterns.md#fill`.
+Fallback relation: Tier 1. Explain failure before using refs, selectors, DOM, mouse, JavaScript, or CDP.
+
+## Fallback Actions
+
+### mouse
+
+Purpose: Coordinate-based mouse operations.
+Usage tier: Tier 5 fallback only.
+
+```bash
+OMNIBOT_SESSION_TOKEN=repair omnibot mouse click --x 100 --y 200 --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=repair omnibot mouse click --x 100 --y 200 --click-count 2 --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=repair omnibot mouse move --x 50 --y 60 --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=repair omnibot mouse scroll --x 100 --y 200 --dy 500 --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=repair omnibot mouse drag --from-x 10 --from-y 20 --to-x 100 --to-y 200 --tab-id <TAB_ID>
+```
+
+Preferred pattern: See `fallback-operations.md#mouse-fallback`.
+Fallback relation: After semantic, refs, selector, and DOM fail.
+
+### dom
+
+Purpose: Interact with visible DOM node ids returned by `dom visible`.
+Usage tier: Tier 4 fallback only.
+
+```bash
+OMNIBOT_SESSION_TOKEN=repair omnibot dom visible --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=repair omnibot dom click n1 --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=repair omnibot dom dblclick n1 --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=repair omnibot dom scroll n1 --dy 800 --tab-id <TAB_ID>
+```
+
+Preferred pattern: See `fallback-operations.md#dom-fallback`.
+Fallback relation: After selector failure and before mouse fallback.
+
+### execute-js
+
+Purpose: Run arbitrary JavaScript in the page.
+Usage tier: Tier 6 fallback only. Do not use first.
+
+```bash
+OMNIBOT_SESSION_TOKEN=repair omnibot execute-js "return location.href" --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=repair omnibot execute-js --file /tmp/repair.js --tab-id <TAB_ID>
+```
+
+Preferred pattern: See `fallback-operations.md#javascript-fallback`.
+Fallback relation: After semantic, refs, selector, DOM, and mouse are insufficient.
+
+### cdp
+
+Purpose: Send raw Chrome DevTools Protocol commands.
+Usage tier: Tier 7 fallback and inspection only.
+
+```bash
+OMNIBOT_SESSION_TOKEN=debug omnibot cdp Runtime.evaluate '{"expression":"document.title"}' --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=debug omnibot cdp DOM.getDocument '{"depth":1}' --tab-id <TAB_ID>
+```
+
+Preferred pattern: See `fallback-operations.md#raw-cdp-fallback` and `debugging-and-evidence.md#cdp-inspection`.
+Fallback relation: Last resort.
+
+## Navigation & Tabs
+
+### navigate / open / goto
+
+Purpose: Navigate or open pages. These commands create or use CLI target state; record the resulting tab id and use `--tab-id` afterward.
+
+```bash
+OMNIBOT_SESSION_TOKEN=research omnibot navigate https://example.com
+OMNIBOT_SESSION_TOKEN=research omnibot navigate --same-tab https://example.com
+OMNIBOT_SESSION_TOKEN=research omnibot open https://example.com
+OMNIBOT_SESSION_TOKEN=research omnibot goto https://example.com
+```
+
+Preferred pattern: See `operation-patterns.md#navigation` and `session-and-tabs.md#tab-explicit`.
+Fallback relation: Verify with `get url --tab-id <TAB_ID>` before continuing.
+
+### close / back / forward / reload / pushstate
+
+Purpose: Change tab lifecycle or history state.
+
+```bash
+OMNIBOT_SESSION_TOKEN=research omnibot close <TAB_ID>
+OMNIBOT_SESSION_TOKEN=research omnibot back --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=research omnibot forward --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=research omnibot reload --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=research omnibot pushstate /dashboard --tab-id <TAB_ID>
+```
+
+Preferred pattern: See `operation-patterns.md#navigation`.
+Fallback relation: Verify URL or page state after the action.
+
+### tab
+
+Purpose: Manage browser tabs.
+
+```bash
+OMNIBOT_SESSION_TOKEN=research omnibot tab list
+OMNIBOT_SESSION_TOKEN=research omnibot tab new https://docs.example.com --label docs
+OMNIBOT_SESSION_TOKEN=research omnibot tab close docs
+```
+
+Preferred pattern: See `session-and-tabs.md#tab-explicit`.
+Removed: `tab switch` and `tab focus` are no longer available. Use explicit `--tab-id` on every page-state command.
+
+### window / frame
+
+Purpose: Manage windows and frames.
+
+```bash
+OMNIBOT_SESSION_TOKEN=research omnibot window new
+OMNIBOT_SESSION_TOKEN=research omnibot frame main
+```
+
+## Waiting & Batch
+
+### wait
+
+Purpose: Wait for time, selector, text, URL, load state, or JavaScript condition.
+
+```bash
+OMNIBOT_SESSION_TOKEN=checkout omnibot wait 500 --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=checkout omnibot wait "#ready" --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=checkout omnibot wait "#spinner" --state hidden --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=checkout omnibot wait --text "Welcome" --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=checkout omnibot wait --url "/dashboard" --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=checkout omnibot wait --load domcontentloaded --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=checkout omnibot wait --load networkidle --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=checkout omnibot wait --fn "window.appReady === true" --tab-id <TAB_ID>
+```
+
+Preferred pattern: See `operation-patterns.md#wait`.
+Fallback relation: Prefer over shell sleep.
+
+### batch
+
+Purpose: Send short command arrays as JSON or from a file.
+
+```bash
+OMNIBOT_SESSION_TOKEN=research omnibot batch '[{"cmd":"scan"},{"cmd":"snapshot","interactive":true}]' --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=research omnibot batch --file /tmp/omnibot-batch.json --tab-id <TAB_ID>
+```
+
+Preferred pattern: See `operation-patterns.md#batch`.
+Fallback relation: Not a substitute for verification.
+
+## Debugging
+
+### screenshot
+
+Purpose: Capture visual evidence from a browser tab.
+
+```bash
+OMNIBOT_SESSION_TOKEN=debug omnibot screenshot --tab-id <TAB_ID> -o /tmp/omni-shot.png
+OMNIBOT_SESSION_TOKEN=debug omnibot screenshot --annotate --tab-id <TAB_ID> -o /tmp/omni-annotated.png
+```
+
+Preferred pattern: See `debugging-and-evidence.md#screenshot`.
+Fallback relation: Evidence collection, not operation fallback.
+
+### console
+
+Purpose: Read or clear browser console evidence.
+
+```bash
+OMNIBOT_SESSION_TOKEN=debug omnibot console logs --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=debug omnibot console errors --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=debug omnibot console clear --tab-id <TAB_ID>
+```
+
+Preferred pattern: See `debugging-and-evidence.md#console`.
+Fallback relation: Evidence collection, not operation fallback.
+
+### network
+
+Purpose: Read browser network evidence.
+
+```bash
+OMNIBOT_SESSION_TOKEN=debug omnibot network logs --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=debug omnibot network summary --tab-id <TAB_ID>
+```
+
+Preferred pattern: See `debugging-and-evidence.md#network`.
+Fallback relation: Evidence collection, not operation fallback.
+
+## Browser Capabilities
+
+### clipboard
+
+Purpose: Read or write browser clipboard.
+
+```bash
+OMNIBOT_SESSION_TOKEN=research omnibot clipboard read --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=research omnibot clipboard write "text" --tab-id <TAB_ID>
+```
+
+Preferred pattern: See `operation-patterns.md#extraction`.
+Fallback relation: Use only when clipboard is part of the browser task.
+
+### viewport
+
+Purpose: Read or set viewport size.
+
+```bash
+OMNIBOT_SESSION_TOKEN=visual omnibot viewport get --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=visual omnibot viewport set 1280 720 --tab-id <TAB_ID>
+```
+
+Preferred pattern: Set explicit viewport before visual verification if layout matters.
+Fallback relation: Not a fallback command.
+
+### assets
+
+Purpose: List or export page resources.
+
+```bash
+OMNIBOT_SESSION_TOKEN=extract omnibot assets list --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=extract omnibot assets export -o /tmp/assets.zip --tab-id <TAB_ID>
+```
+
+Preferred pattern: See `operation-patterns.md#extraction`.
+Fallback relation: Use after page content indicates assets are needed.
+
+## Visibility & Sessions
+
+### visibility
+
+Purpose: Inspect, set, or launch automation browser visibility mode.
+
+```bash
+omnibot visibility status
+omnibot visibility set background
+omnibot visibility set visible
+omnibot visibility set headless --user-data-dir /tmp/omnibot-headless
+omnibot visibility launch headless --user-data-dir /tmp/omnibot-headless
+```
+
+Preferred pattern: See `session-and-tabs.md#visibility`.
+Fallback relation: Headless does not inherit existing user login state.
+
+### browser
+
+Purpose: Manage browser runtime ownership.
+
+```bash
+OMNIBOT_SESSION_TOKEN=research omnibot browser list
+OMNIBOT_SESSION_TOKEN=research omnibot browser current
+OMNIBOT_SESSION_TOKEN=research omnibot browser claim 123
+OMNIBOT_SESSION_TOKEN=research omnibot browser release 123
+```
+
+Preferred pattern: See `session-and-tabs.md#browser-claimrelease`.
+Fallback relation: Use in multi-browser or multi-runtime scenarios.
+
+### session
+
+Purpose: Name or list sessions.
+
+```bash
+OMNIBOT_SESSION_TOKEN=checkout omnibot session name "checkout"
+OMNIBOT_SESSION_TOKEN=checkout omnibot session list
+```
+
+Preferred pattern: See `session-and-tabs.md#session-first`.
+Fallback relation: Not a fallback command.
+
+## Recording & Trace
+
+### record / replay / trace
+
+Purpose: Capture, replay, or trace workflows for evidence.
+
+```bash
+OMNIBOT_SESSION_TOKEN=debug omnibot record start
+OMNIBOT_SESSION_TOKEN=debug omnibot record stop -o flow.json
+OMNIBOT_SESSION_TOKEN=debug omnibot replay flow.json
+OMNIBOT_SESSION_TOKEN=debug omnibot trace start
+OMNIBOT_SESSION_TOKEN=debug omnibot trace stop -o trace.zip
+```
+
+Preferred pattern: See `debugging-and-evidence.md#record-and-replay` and `debugging-and-evidence.md#trace`.
+Fallback relation: Evidence collection, not operation fallback.
+
+## Skills & License
+
+### skills install / skills path
+
+Purpose: Install packaged omnibot skills or show the packaged skills path.
+
+```bash
+omnibot skills install --agent hermes --profile nuwa
+omnibot skills install --agent opencode
+omnibot skills install --agent claude
+omnibot skills install --agent codex
+omnibot skills path
+```
+
+Preferred pattern: See `runtime-and-status.md#skills-path`.
+Fallback relation: Not a fallback command.
+
+### license status
+
+Purpose: Inspect license status.
+
+```bash
+omnibot license status
+```
+
+Preferred pattern: See `runtime-and-status.md#startup-check`.
+Fallback relation: Not a fallback command.

package/bin/omnibot-windows-x64/omnibot/skills/omnibot/references/debugging-and-evidence.md

@@ -0,0 +1,95 @@
+# Debugging and Evidence
+
+Debugging is for evidence. Fallback is for completing operations.
+
+Use this file when you need to prove browser state, explain a failure, or collect artifacts for review. Do not use `execute-js` as the first debug tool.
+
+## Screenshot
+
+Use screenshots when visual layout, canvas, dialogs, or visual regressions matter.
+
+```bash
+OMNIBOT_SESSION_TOKEN=debug omnibot screenshot --tab-id <TAB_ID> -o /tmp/omni-shot.png
+OMNIBOT_SESSION_TOKEN=debug omnibot screenshot --annotate --tab-id <TAB_ID> -o /tmp/omni-annotated.png
+```
+
+Prefer text extraction when text is enough. Screenshot is evidence, not extraction.
+
+## Console
+
+Use console logs for runtime JavaScript errors, frontend warnings, or app-level diagnostics.
+
+```bash
+OMNIBOT_SESSION_TOKEN=debug omnibot console errors --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=debug omnibot console logs --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=debug omnibot console clear --tab-id <TAB_ID>
+```
+
+Collect console errors before and after the action when debugging regressions.
+
+## Network
+
+Use network logs for failed requests, redirects, blocked assets, API errors, or loading stalls.
+
+```bash
+OMNIBOT_SESSION_TOKEN=debug omnibot network summary --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=debug omnibot network logs --tab-id <TAB_ID>
+```
+
+Pair network evidence with page verification:
+
+```bash
+OMNIBOT_SESSION_TOKEN=debug omnibot get text "#main" --tab-id <TAB_ID>
+```
+
+## Trace
+
+Use trace for a reproducible artifact around a failing workflow.
+
+```bash
+OMNIBOT_SESSION_TOKEN=debug omnibot trace start
+OMNIBOT_SESSION_TOKEN=debug omnibot click --tab-id <TAB_ID> @e4
+OMNIBOT_SESSION_TOKEN=debug omnibot snapshot -i --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=debug omnibot trace stop -o trace.zip
+```
+
+Trace is evidence. It does not replace operation verification.
+
+## Record and Replay
+
+Use record/replay when a flow must be captured or reproduced.
+
+```bash
+OMNIBOT_SESSION_TOKEN=debug omnibot record start
+OMNIBOT_SESSION_TOKEN=debug omnibot click --tab-id <TAB_ID> @e4
+OMNIBOT_SESSION_TOKEN=debug omnibot snapshot -i --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=debug omnibot record stop -o flow.json
+OMNIBOT_SESSION_TOKEN=debug omnibot replay flow.json
+```
+
+After replay, verify final state:
+
+```bash
+OMNIBOT_SESSION_TOKEN=debug omnibot get url --tab-id <TAB_ID>
+```
+
+## CDP Inspection
+
+Use CDP for low-level inspection when normal evidence is insufficient.
+
+```bash
+OMNIBOT_SESSION_TOKEN=debug omnibot cdp Runtime.evaluate '{"expression":"document.title"}' --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=debug omnibot cdp DOM.getDocument '{"depth":1}' --tab-id <TAB_ID>
+```
+
+CDP inspection is not a first-choice operation path. If CDP changes state, it becomes Tier 7 fallback and must follow `fallback-operations.md#raw-cdp-fallback`.
+
+## Evidence Checklist
+
+Before reporting a browser issue, collect the smallest evidence set that explains it:
+
+- Runtime: `doctor`, `tabs`, `visibility status`.
+- Page state: `get`, `is`, `scan`, or `snapshot`.
+- Visual proof: `screenshot --annotate` only if visual state matters.
+- Browser diagnostics: `console errors` and `network summary`.
+- Reproduction artifact: `trace` or `record` when the flow is unstable.