Browzer
Extension setupConnected terminals
Terminal capture

Browzer CLI Setup

The terminal companion for Browzer recordings. It captures the commands you run, records the terminal window, and merges that context with your browser actions in one workflow.

curl -fsSL https://trybrowzer.com/cli/install.sh | sh

Command capture and terminal-window video capture are supported.

macOS and Linux are supported. Windows support is not available yet. The command is safe to run again anytime to refresh hooks or re-pair a device.

Supported platforms

macOS Apple Silicondarwin-arm64Commands and terminal video
macOS Inteldarwin-x86_64Commands and terminal video
Linux arm64linux-arm64Commands only
Linux x86_64linux-x86_64Commands only
Windowsnot availableRequires a separate PowerShell installer and capture backend.

Get set up

1

Run the install command

One command downloads the right release artifact, verifies its checksum, wires your shell hooks, and opens Browzer to pair this terminal.

What the installer does

  • Detects macOS or Linux and downloads the matching browzer-shell artifact.
  • Uses a signed and notarized archive for macOS releases.
  • Verifies the downloaded artifact checksum before installing it.
  • Installs it as browzer-shell and browzer in ~/.local/bin.
  • Adds ~/.local/bin to your zsh or bash startup file when needed.
  • Installs the lightweight shell hooks that capture commands during recordings.
  • Opens the browser pairing flow to link the terminal to your account.
2

Grant macOS permissions

Required only for terminal window video capture. Skip this on Linux.

Enable Screen Recording for your terminal app in System Settings.

Enable Accessibility so Browzer can capture only the frontmost terminal window, not the whole screen.

After changing permissions, restart your terminal and run browzer install to verify.

3

Verify the install

Run this once the installer finishes.

browzer status

You should see your device name and whether this terminal is currently recording.

4

Start recording

Run browzer start in the terminal, or start from the Chrome extension. Connected terminals join browser-started recordings automatically.

CLI commands

The daily commands are intentionally small.

browzer statusCheck login state and active recording status.
browzer versionShow the installed CLI version.
browzer version --checkCheck whether a newer CLI release is available.
browzer updateDownload and install the latest packaged CLI.
browzer update --enable-autoOpt in to daily background update checks.
browzer loginPair this terminal again if credentials were revoked.
browzer installReinstall shell hooks after changing shells or permissions.
browzer startStart a terminal-owned recording session.
browzer stopStop and upload a terminal-owned recording session.

Troubleshooting

Fast checks for the most common setup issues.

Command not found

Open a new terminal, or run source ~/.zshrc or source ~/.bashrc.

Video is missing

Recheck Screen Recording and Accessibility permissions, then restart the terminal app before recording again.

Wrong account

Run browzer logout and then browzer login.

Need a hand with setup? Mail us at rahul@trybrowzer.com.

Manage terminals