Routing
Prepare only the Appium Chromium route for Chrome, Chromium, or Edge desktop browsers. Use driver-specific official guidance for an existing runtime failure after setup passes.
Required inputs
Confirm the browser and executable when non-default, global appium mode or
explicitly requested local npx appium mode, host OS, permissions, and whether
a session-time browser-driver download is authorized.
Workflow
- Load the global command profile by default or the local profile only when explicitly requested.
- Load the Chromium profile, shared Appium setup basics, browser prerequisites, and Chromium decision, driver-validation, and smoke references.
- Run
node tools/appium/setup/scripts/check-chromium-env.mjs --format summary --report auto; add--appium-mode localonly for explicitly requested local mode. Require top-levelsummary.requiredOk: true. Apply required fixes in technical dependency order and rerun affected checks. If the gate remains unresolved, reportblockedwith evidence and the next action. Load the matching example only when needed. - Verify
appium driver doctor chromiumreports0 required fixes needed, or recordnot-supportedand require the install, list, browser, and smoke gates instead. Usenpx --no-install appium ...for the direct check in local mode. - Run
node tools/appium/setup/scripts/smoke-appium-server.mjs --driver chromium --report auto; add--appium-mode localonly in local mode. Requiresummary.requiredOk: truefor server readiness, driver evidence, and cleanup. The smoke reference documents target-specific options. This also requires a browser session to be created and deleted successfully.
Chromium setup safety and approval constraints
- Ask before privileged package-manager commands, browser installation, or a session-time browser-driver download.
- Preserve the selected command mode and existing working browser and driver installations.
Completion criteria
- Appium succeeds in the selected command mode with major version
>= 3. - The installed driver list includes
chromium. - At least one supported Chromium browser is available.
- Doctor reports
0 required fixes neededwhen supported; otherwise the install, list, browser, and smoke gates pass. /statussucceeds, logs listchromium, and the minimal browser session helper reports top-levelsummary.requiredOk: true.
Evidence boundary
Report Appium and driver versions, browser and executable evidence, helper and
doctor summaries, /status, server driver evidence, minimal session result,
and cleanup.
Self-Improvement Prompt
Before the final response, report any missing, ambiguous, outdated, or retry-causing Chromium setup instruction with its asset path and proposed wording. Leave unrelated assets unchanged.