--session global flag when you need to target a named parallel instance. Before using any element-based command after navigation, run gsd-browser snapshot to capture fresh, versioned refs for the new page state.
Global Flags
These flags are accepted by everygsd-browser command, not just navigation commands.
Emit machine-readable JSON on stdout instead of human-readable text. Errors are also written as JSON to stderr.
Target a named daemon session. Use this when you have multiple parallel browser instances running side-by-side.
Path to a custom Chrome or Chromium binary. Overrides the value set in your config file.
Connect to an already-running Chrome instance via a Chrome DevTools Protocol (CDP) endpoint (e.g.
ws://localhost:9222). Accepts both ws:// and http:// endpoints.Skip the lead-time sleeps that gsd-browser inserts between narrated actions. Useful in CI where speed matters more than realistic pacing.
gsd-browser navigate
Navigate the active tab to a URL. The command waits for the page to load before returning. Combine with a subsequent gsd-browser wait-for call when you need finer control over the ready condition.
The fully-qualified URL to navigate to (e.g.
https://example.com/login).gsd-browser back
Go back one step in the active tab’s navigation history — the browser equivalent of clicking the Back button.
gsd-browser forward
Go forward one step in the active tab’s navigation history — the browser equivalent of clicking the Forward button.
gsd-browser reload
Reload the current page.
gsd-browser wait-for
Block until a specified page condition becomes true. Use wait-for after actions that trigger asynchronous changes — navigation, form submission, AJAX calls, or animations — before your next interaction step.
The condition to wait for. Supported values:
| Condition | Description |
|---|---|
selector_visible | An element matching --value appears in the DOM and is visible |
selector_hidden | An element matching --value is removed or hidden |
url_contains | The current URL contains the substring in --value |
network_idle | No pending network requests for a short period |
delay | Wait a fixed number of milliseconds (set with --value) |
text_visible | Text matching --value appears on the page |
text_hidden | Text matching --value disappears from the page |
request_completed | A network request whose URL contains --value completes |
console_message | A console message containing --value is logged |
element_count | The count of elements matching --value satisfies --threshold |
region_stable | The element at --value stops changing (useful after animations) |
Condition-specific value: a CSS selector, URL substring, text string, or delay in milliseconds depending on the chosen
--condition.Maximum time to wait in milliseconds before the command fails. Defaults to
10000 (10 seconds).Comparison expression for
element_count, e.g. >=3, ==0, <5.