CLI reference
The SDK starts and connects to the runtime for you. These flags are useful when you manage the process yourself.
| Flag | Default | Purpose |
|---|---|---|
--listen | 127.0.0.1:9222 | CDP HTTP and WebSocket address. |
--chrome | 152 | Loaded Chrome compatibility milestone. It does not install Chrome. |
--browser-mode | headful | Choose the observed environment profile: headful or headless. Mimic does not open a browser window. SDK launch uses the headless profile. |
--resource-policy | none | Path to a JSON resource policy applied to new Contexts. See resource policies. |
--profile | none | Named or exported workload profile created by Optimize. Environment JSON uses CDP import/export. |
--engine | v8 | JavaScript engine: v8, quickjs, or goja. Fallbacks do not promise V8 equivalence. |
--navigation-timeout | 0 | Optional navigation execution cap as a duration, such as 30s or 2m. Zero waits until completion or cancellation. |
--dev-preview | false | Enables the visual debug viewer at /debug/preview/; this is not native rendering. |