Skip to content

feat(cli): integrate agent-browser runtime and top-level API tools#38

Merged
hussufo merged 21 commits intomainfrom
huss/agent-cli
Feb 27, 2026
Merged

feat(cli): integrate agent-browser runtime and top-level API tools#38
hussufo merged 21 commits intomainfrom
huss/agent-cli

Conversation

@hussufo
Copy link
Contributor

@hussufo hussufo commented Feb 27, 2026

This pull request introduces major improvements to documentation, command reference clarity, and workflow reliability for the Steel CLI. The most significant changes are a full rewrite and expansion of the README.md and documentation files, the addition of new compatibility and migration guides, and updates to GitHub Actions workflows to ensure browser runtime compatibility across platforms before publishing or releasing. The CLI reference documentation now features more accurate command lists, improved template names, and additional details for new and existing commands.

Documentation and User Guidance Improvements:

  • Completely rewrote and expanded README.md to clarify installation, usage, endpoint resolution, browser integration, command overview, auto-update logic, and documentation map. Added migration, compatibility, and troubleshooting references.
  • Added docs/browser-compat.md to document compatibility between steel browser and upstream agent-browser, including a behavior matrix, known differences, and validation targets.
  • Updated docs/README.md to clarify the distinction between generated and hand-maintained docs, provide a docs map, and explain regeneration steps.

CLI Reference and Command Improvements:

  • Improved the generated CLI reference in docs/cli-reference.md by updating the Table of Contents, adding new commands (config, pdf, scrape, screenshot, settings, update, browser live, browser sessions, dev install/start/stop), and refining descriptions. [1] [2] [3]
  • Standardized and renamed all forge templates in the CLI reference to use steel-*-starter naming for clarity and consistency.
  • Added new command details and options, such as the pdf command and support for the --anthropic_key flag, and improved documentation for existing commands.

Workflow Reliability and Cross-Platform Testing:

  • Updated .github/workflows/npm-publish.yml and .github/workflows/release.yml to add a browser-runtime-smoke job that runs browser smoke tests on Ubuntu, macOS, and Windows before publishing or releasing, ensuring cross-platform compatibility. The publish/release jobs now depend on these smoke checks. [1] [2]This pull request introduces several significant improvements to documentation, workflow automation, and command compatibility for the Steel CLI. The most important changes include a major overhaul of the README.md for clarity and completeness, the addition of a browser compatibility document, updates to the auto-generated CLI reference, and enhancements to CI workflows to ensure cross-platform browser runtime checks.

Documentation and Reference Improvements:

  • Major rewrite and expansion of README.md to provide a clearer overview, quick start guides, endpoint resolution details, agent-browser integration, command grouping, and a comprehensive documentation map.
  • Added docs/browser-compat.md to document the compatibility matrix and behavioral differences between steel browser and upstream agent-browser, including known differences and deferred mappings.
  • Updated docs/README.md to clarify the structure and regeneration process for documentation, and to distinguish between generated and hand-maintained docs.
  • Improved the auto-generated docs/cli-reference.md with a more accurate table of contents, clearer command descriptions, expanded command coverage (including new and updated commands), and updated template names for the forge command. [1] [2] [3] [4] [5]

CI Workflow Enhancements:

  • Added a browser-runtime-smoke job to both release.yml and npm-publish.yml workflows, running browser runtime smoke tests across Ubuntu, macOS, and Windows, and made publishing/release jobs depend on successful completion of these checks. [1] [2]

hussufo and others added 21 commits February 25, 2026 00:23
Relocate Docker-based local browser controls to steel dev start/stop and update browser command descriptions/docs to point local usage to dev commands.
Adds repeatable cold/warm benchmark scenarios with budget thresholds and mock session API wiring for regression checks.
Switches Steel bootstrap injection to --cdp, preserves bare --auto-connect discovery, and rejects mixed attach flags. Bundles upstream daemon dist assets with vendored runtime, auto-sets AGENT_BROWSER_HOME for vendored execution, and adds runtime/cloud smoke validation scripts.
Adds a dependency guard script and wires it into build to prevent accidental playwright installs or lockfile drift away from playwright-core.
…nstall flow

- add --api-url support across browser lifecycle and passthrough bootstrap

- add steel dev install and explicit local runtime install/start/stop boundaries

- improve localhost local-mode guidance and add cloud integration + unit coverage
- add browser compatibility, migration, upstream sync, and reference index docs

- update generated CLI docs and docs generator option naming

- record authenticated cloud smoke pass in implementation plan
@hussufo hussufo merged commit 9322f1a into main Feb 27, 2026
@hussufo hussufo deleted the huss/agent-cli branch February 27, 2026 22:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants