Vibeleaderboard
← Back to Tools
Index / tool

Stagehand CLI

https://github.com/browserbase/stagehand-cli
Visit github.com
Category
AI Agents
Rank
No. 1139Tools index
Pricing
Open Source
Type
TOOL
Builder
browserbase
GitHub
1 stars
Latest release
v0.7.0
Date

About

Command-line interface for Stagehand. Control remote browser sessions running in Browserbase cloud from your terminal.

What it does

Stagehand CLI turns the Stagehand REST API into resource-oriented terminal commands. You create a browser session, then navigate, inspect possible actions, perform instructions, extract structured data, run multi-step agents, and end the session using its returned identifier.

Why it's ranked here

It offers unusually broad session control without requiring a custom client program. Natural-language actions sit beside navigation, observation, schema-guided extraction, and autonomous execution. Flexible output formatting and piped request bodies make it useful for both interactive investigation and shell automation.

What's good

The command surface mirrors the API resources, which keeps discovery predictable. It accepts request bodies from standard input and merges command flags over mapped input. Responses can be rendered as JSON, JSONL, YAML, raw text, formatted JSON, or an interactive explorer, with optional GJSON transformations.

Tradeoffs

Installation requires the Go toolchain, and operation depends on the Stagehand REST API rather than a self-contained browser runtime. The exposed resource surface is limited to sessions. Debug logging includes full HTTP request and response details, so it may reveal sensitive headers or payloads in logs.

How to use it well

Use it for engineers testing Stagehand calls, scripting browser-session workflows, or inspecting structured responses before writing application code. Pipe YAML or JSON for complex request bodies, choose machine-readable output in automation, and reserve the interactive explorer for terminal work. It does not replace application-level SDK integration.

Technical notes+

README.md identifies the project as a Stainless-generated CLI for the Stagehand REST API. go.mod declares Go 1.25 and depends on github.com/browserbase/stagehand-go plus urfave/cli and Charmbracelet terminal libraries. pkg/cmd/cmd.go defines global base URL, output format, error format, transformation, debug, completion, and manpage facilities. pkg/cmd/session.go exposes sessions act, end, execute, extract, navigate, observe, and start, including SSE-related flags. pkg/cmd/flagoptions.go reads piped YAML or JSON, merges body flags, and builds query, header, multipart, or JSON request options. pkg/cmd/cmdutil_unix.go uses socket pairs for paging, while pkg/cmd/cmdutil_windows.go falls back to pipes. pkg/cmd/cmdutil_test.go contains a focused pager-streaming test.

Observed

Primary language
Go
Packaging and installation
Installed with Go using the repository command package at latest
Interface
Command-line client for the Stagehand REST API
Command structure
Resource-based CLI with session start, navigate, observe, act, extract, execute, and end operations
Platform support
Separate Unix-like and Windows output-streaming implementations
Generated surface
Command code states that it is generated from an OpenAPI specification by Stainless

Read from README.md, go.mod, pkg/cmd/cmd.go, pkg/cmd/cmdutil.go, pkg/cmd/session.go, pkg/cmd/suggest.go, pkg/cmd/version.go, pkg/cmd/flagoptions.go, pkg/cmd/cmdutil_test.go, pkg/cmd/cmdutil_unix.go, internal/apiform/form.go, pkg/jsonview/explorer.go, internal/apiquery/query.go, pkg/cmd/cmdutil_windows.go, internal/apiform/encoder.go.

What it can do

  • Connect to remote browser sessions

    Browserbase cloud credentials and session details → Active connection to remote browser instance

  • Control browser navigation

    URL or navigation commands → Browser navigated to specified page or location

  • Execute browser automation scripts

    Automation commands or scripts → Automated browser actions performed

  • Monitor browser session status

    Session identifier or connection details → Real-time session status and information

  • Manage multiple browser sessions

    Session management commands → Created, terminated, or switched browser sessions

  • Extract data from web pages

    Web page elements or selectors → Scraped data or content from browser

Tags

stagehandbrowserbasebrowser-automationcliai-agents

Tech Stack

Go

Comments (0)

No comments yet

Editorially curated, with community endorsements as a secondary signal. Corrections welcome.