Navigation

The plugin provides deterministic navigation using pre-crawled metadata.

Selector Priority Chain

The automation uses this selector priority for reliable element targeting:

1. data_testid
2. aria_label
3. text_match
4. css
5. ref

How It Works

Before v2.2 (Session-Specific Refs)

Claude: Uses ref_27 from metadata
Risk: Refs change between browser sessions
Result: ~70% success rate

After v2.2 (Stable Selectors)

Claude: Uses data_testid > aria_label > text_match fallback
Uses: mcp__claude-in-chrome__find with stable selector
Result: ~95% success rate across sessions

Navigation Commands

Basic Navigation

/xc:console nav home      # Go to console home
/xc:console nav waap      # Go to WAAP workspace
/xc:console nav http-lb   # Go to HTTP Load Balancers

Workspace Shortcuts

Shortcut	Path
account	/web/workspaces/account-protection
admin	/web/workspaces/administration
audit	/web/workspaces/audit-logs-alerts
auth	/web/workspaces/authentication-intelligence
bigip	/web/workspaces/bigip-utilities
bot	/web/workspaces/bot-defense
catalog	/web/catalog/use-cases
cdn	/web/workspaces/content-delivery-network
csd	/web/workspaces/client-side-defense
data-intel	/web/workspaces/data-intelligence
ddos	/web/workspaces/routed-ddos
delegated	/web/workspaces/delegated-access
dns	/web/workspaces/dns-management
home	/web/home
mac	/web/workspaces/multi-cloud-app-connect
mcn	/web/workspaces/multi-cloud-network-connect
nginx	/web/workspaces/nginx-one
observe	/web/workspaces/observability
scan	/web/workspaces/web-app-scanning
shared	/web/workspaces/shared-configuration
traffic	/web/workspaces/application-traffic-insight
waap	/web/workspaces/web-app-and-api-protection

Element Metadata Structure

Each element includes both refs and stable selectors:

{
  "add_button": {
    "ref": "ref_27",
    "text": "Add HTTP Load Balancer",
    "selectors": {
      "data_testid": null,
      "aria_label": "Add HTTP Load Balancer",
      "text_match": "Add HTTP Load Balancer",
      "css": "button:has-text('Add HTTP Load Balancer')"
    }
  }
}

Fallback Strategy

When navigating, Claude uses this priority:

1. Try data_testid selector (most stable)
2. Try aria_label selector
3. Try text_match with find()
4. Try css selector
5. Try session-specific ref (may be stale)
6. Report mismatch for metadata update