Masih-0x3 Steel Browser
Use Steel CLI browser tools to complete live web work now.
Setup
If Steel is missing or unauthenticated:
steel --version
steel login
steel doctor --preflight
If the CLI or installed skills look broken, run:
steel skills doctor
Done when this smoke test succeeds:
steel scrape https://example.com
Choose The Right Path
- Static page content:
steel scrape <url> - Screenshot:
steel screenshot <url> - PDF:
steel pdf <url> - Multi-step interaction, login, forms, or JS-heavy pages:
steel browser ... - Bot detection, CAPTCHA, proxy, or login reliability failure: collect evidence with
steel-session-debugging, then usesteel-reliability - Reusable application code: use
steel-developer
Start with the smallest tool that can finish the task. Escalate from scrape/screenshot/PDF to an interactive browser session only when interaction or state is required.
Interactive Session Workflow
steel browser start --session my-task --session-timeout 3600000
steel browser navigate https://example.com --session my-task
steel browser snapshot -i --session my-task
steel browser click @e1 --session my-task
steel browser wait --load networkidle --session my-task
steel browser snapshot -i --session my-task
steel browser stop --session my-task
Rules:
- Always use the same
--session <name>on every command. - Take a fresh
snapshot -iafter navigation or DOM changes because element refs expire. - Prefer
@eNrefs from snapshots over brittle CSS selectors. - Use
steel browser batchwhen a sequence needs an action and immediate re-snapshot. - Release/stop sessions unless the user explicitly asks to keep them open.
Troubleshooting
- Run
steel skills doctorfor install or CLI-skill mismatch issues. - Run
steel doctor --preflightfor auth/API issues. - Use
steel browser sessionsandsteel browser live --session <name>for active sessions. - For failed completed sessions, load
steel-session-debugging. - For bot/proxy/CAPTCHA/identity fixes, load
steel-reliability.
References
references/steel-browser-commands.md: command reference.references/steel-browser-lifecycle.md: session lifecycle discipline.references/troubleshooting.md: recovery playbooks.references/migration-agent-browser.md: migration from upstreamagent-browser.