mirror of https://github.com/browseros-ai/BrowserOS.git synced 2026-05-13 15:46:22 +00:00

Files

shivammittal274 565ce18eba feat: add npm/npx distribution for BrowserOS CLI (#618 )

* feat(cli): skip self-update prompts for package manager installs

Checks BROWSEROS_INSTALL_METHOD env var (npm, brew) and skips automatic
update checks. Users should use their package manager's update mechanism.
FormatNotice now shows the appropriate upgrade command based on install method.

* feat(cli): add npm bin wrapper for browseros-cli

* feat(cli): add npm postinstall script to download platform binary

Downloads the correct platform binary from GitHub releases during npm
install, verifies SHA256 checksums, and extracts to .binary directory.

* feat(cli): add npm package metadata and README

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: move npm package files to correct monorepo path

The bin wrapper and postinstall were created at apps/cli/npm/ instead of
packages/browseros-agent/apps/cli/npm/. Moves them to the correct location.

* style: use node: protocol for builtin module imports

* feat(cli): add Makefile npm targets and release workflow npm publish step

Adds npm-version and npm-publish Makefile targets for version sync.
Adds Node.js setup and npm publish step to the release workflow.
Adds npm/npx install instructions to release notes template.

* fix(cli): fail on missing checksum entry and limit redirect depth

- Abort if checksums.txt downloaded but archive entry is missing
- Warn if checksums.txt itself failed to download
- Cap redirect depth at 5 to prevent stack overflow on circular redirects

* fix(cli): match install.sh checksum behavior — warn instead of abort

The existing shell installer (install.sh) warns and continues when the
checksum entry is missing from checksums.txt. Match that behavior in the
npm postinstall to avoid unnecessary install failures. Both files come
from the same GitHub release, so the checksum is a corruption check,
not a strong security boundary.

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-03-30 22:30:58 +05:30

1.3 KiB

Raw Permalink Blame History

browseros-cli

Command-line interface for controlling BrowserOS -- launch and automate the browser from the terminal.

Installation

Zero install (recommended):

npx browseros-cli --help

Global install:

npm install -g browseros-cli

Shell script fallback:

curl -fsSL https://cdn.browseros.com/cli/install.sh | bash

Quick Start

# Download BrowserOS
browseros-cli install

# Start BrowserOS
browseros-cli launch

# Auto-configure MCP settings for your AI tools
browseros-cli init --auto

# Verify everything is working
browseros-cli health

Usage

browseros-cli navigate "https://example.com"

Observation

browseros-cli snapshot           # Get the accessibility tree of the current page
browseros-cli console-logs       # View browser console output

Screenshots

browseros-cli screenshot         # Capture the current page

Input

browseros-cli click 42           # Click an element by its node ID
browseros-cli fill 85 "query"    # Type text into an input field

Agent Mode

browseros-cli agent "Search for flights to Tokyo"

Documentation

Full documentation is available at browseros.com.

License

MIT

1.3 KiB Raw Permalink Blame History