Gologin Local Agent Browser CLI

Gologin Local Agent Browser CLI is an agent-friendly CLI for running local Gologin Orbita profiles through a persistent daemon and a compact shell interface. It keeps the same interaction model as the cloud Agent Browser CLI — open a session, read snapshots, act on refs — but runs locally on your machine using Gologin Orbita instead of Cloud Browser.

When to use local vs cloud

Use local when	Use cloud when
Profile warmup	Quick stateless scraping
Account login flows	No local machine available
Cookie accumulation	Parallel sessions at scale
Social / marketplace actions inside a persistent profile	One-off browser tasks
Agent loops that reuse the same local identity	No need for persistent profile state

Install

npm install -g gologin-local-agent-browser-cli

Requires Node.js >= 20.

Credentials

Variable	Required	Description
`GOLOGIN_TOKEN`	Yes (for `open`)	Gologin API token
`GOLOGIN_PROFILE_ID`	Optional	Default profile ID
`GOLOGIN_DAEMON_PORT`	Optional	Daemon port (default: `44778`)
`GOLOGIN_HEADLESS`	Optional	`true` or `false` (default: `false`)
`GOLOGIN_EXECUTABLE_PATH`	Optional	Path to Orbita executable
`GOLOGIN_TMPDIR`	Optional	Gologin temp/profile directory

Config file: ~/.gologin-local-agent-browser/config.json

Architecture

Two parts:

gologin-local-agent-browser CLI — parses commands, auto-starts daemon
Persistent local daemon — launches local Orbita through the official Gologin SDK, connects to the returned websocket endpoint with Playwright connectOverCDP, keeps the active page in memory

Quick start

export GOLOGIN_TOKEN='your_token'

# open a profile locally (visible window)
gologin-local-agent-browser open https://example.com --profile your_profile_id

# or headless
gologin-local-agent-browser open https://example.com --profile your_profile_id --headless

# read the page
gologin-local-agent-browser snapshot

# interact
gologin-local-agent-browser click @e3
gologin-local-agent-browser type @e5 "search terms"

# save a screenshot
gologin-local-agent-browser screenshot ./page.png

# close
gologin-local-agent-browser close

Profile management

Manage Gologin profiles directly from the CLI.

Command	Description
`profiles`	List profiles (local, remote, or all)
`profile <id>`	Show profile details
`profile-create <name>`	Create a new profile
`profile-import <id>`	Import a remote profile locally
`profile-update <id>`	Update profile settings
`profile-sync <id>`	Sync local profile to cloud
`profile-delete <id>`	Delete a profile

Filters for profiles: --local, --remote, --all, --platform <os>, --status <status>, --tag <tag>, --search <query>, --json

Use-case templates

Create profiles pre-configured for specific workflows:

gologin-local-agent-browser profile-create "My LinkedIn" --template linkedin
gologin-local-agent-browser profile-create "Ad Account 1" --template ads
gologin-local-agent-browser profile-create "Social Manager" --template smm

Template	Purpose
`linkedin`	Warmup-oriented leadgen profile
`ads` / `facebook`	Ads operator profile with strong account isolation
`smm`	Shared-access social profile for cookie/storage handoffs
`scraping`	Automation-oriented local profile
`geo`	Geo-testing profile

Doctor diagnostics

Check profile health, proxy connectivity, and use-case readiness:

# basic health check
gologin-local-agent-browser doctor

# check for a specific use case
gologin-local-agent-browser doctor --use-case linkedin

# check proxy on a profile
gologin-local-agent-browser doctor --use-case linkedin --check-proxy your_profile_id

Runbooks and batch execution

Single runbook

gologin-local-agent-browser run ./warmup.json --profile your_profile_id --name reddit-warmup

Runbook format:

{
  "variables": { "url": "https://www.reddit.com" },
  "steps": [
    { "command": "open-visible", "args": ["${url}"] },
    { "command": "wait", "args": [1500] },
    { "command": "scroll", "args": ["down", 900] },
    { "command": "wait", "args": [1000] },
    { "command": "scroll", "args": ["down", 900] },
    { "command": "close" }
  ]
}

Batch execution

Run a runbook against multiple profiles in parallel:

gologin-local-agent-browser batch ./warmup.json \
  --targets ./targets.json \
  --concurrency 5 \
  --name short-warmup

Jobs and history

Track runbook and batch execution:

# list all jobs
gologin-local-agent-browser jobs

# filter by kind and status
gologin-local-agent-browser jobs --kind batch --status failed

# get details for a specific job
gologin-local-agent-browser job job-20260311123000-ab12cd34

Visibility controls

Flag	Behavior
`--visible` / `--headed`	Start Orbita with a visible window
`--background` / `--headless`	Run without visible window
Default	Falls back to `GOLOGIN_HEADLESS` env or visible mode

Aliases: open-visible = open --visible, open-background = open --background

Use cases and examples

Warm up new accounts

New browser profiles look “cold” — no cookies, no browsing history, no stored sessions. Sites like Facebook, Google, and LinkedIn flag cold profiles. Warm them up by browsing naturally before doing anything important.

{
  "variables": { "url": "https://www.google.com" },
  "steps": [
    { "command": "open-visible", "args": ["${url}"] },
    { "command": "wait", "args": [2000] },
    { "command": "scroll", "args": ["down", 500] },
    { "command": "wait", "args": [1500] },
    { "command": "scroll", "args": ["down", 500] },
    { "command": "wait", "args": [1000] },
    { "command": "close" }
  ]
}

Run across 20 profiles in parallel:

gologin-local-agent-browser batch ./warmup.json \
  --targets ./20-new-profiles.json \
  --concurrency 5 --name daily-warmup

LinkedIn outreach with persistent profiles

Each LinkedIn account lives in its own profile with its own cookies, proxy, and fingerprint. Log in once, the session persists across days.

# create a LinkedIn-optimized profile
gologin-local-agent-browser profile-create "LinkedIn - Sales Rep 1" \
  --template linkedin --proxy-country us

# log in (visible mode to handle 2FA if needed)
gologin-local-agent-browser open https://linkedin.com/login \
  --profile profile_id --visible

gologin-local-agent-browser snapshot
gologin-local-agent-browser fill @e3 "email@company.com"
gologin-local-agent-browser fill @e5 "password"
gologin-local-agent-browser click @e7
gologin-local-agent-browser wait 5000

# verify login, then close — cookies are saved
gologin-local-agent-browser snapshot
gologin-local-agent-browser close

# next day: reopen — already logged in
gologin-local-agent-browser open https://linkedin.com/feed --profile profile_id
gologin-local-agent-browser snapshot   # feed loads, no login needed

Manage multiple ad accounts

Run Facebook/Google ad accounts with isolated profiles — each account gets its own fingerprint, proxy, and cookie jar.

# create profiles for each ad account
gologin-local-agent-browser profile-create "FB Ads - Client A" --template ads --proxy-country us
gologin-local-agent-browser profile-create "FB Ads - Client B" --template ads --proxy-country gb
gologin-local-agent-browser profile-create "Google Ads - Client C" --template ads --proxy-country de

# check proxy and fingerprint health before running
gologin-local-agent-browser doctor --use-case ads --check-proxy profile_id_A

Multiple Instagram, TikTok, or Reddit accounts — each in its own profile. Post content, engage, monitor — all through the CLI.

# create an SMM profile
gologin-local-agent-browser profile-create "Reddit Account 3" --template smm

# open, browse, interact
gologin-local-agent-browser open https://reddit.com --profile profile_id --visible
gologin-local-agent-browser snapshot
gologin-local-agent-browser find "search input"
gologin-local-agent-browser type @found "r/programming"
gologin-local-agent-browser press Enter
gologin-local-agent-browser wait 2000
gologin-local-agent-browser snapshot
gologin-local-agent-browser close

E-commerce and marketplace operations

Manage multiple seller accounts on Amazon, eBay, Etsy — each isolated with its own profile.

# batch warmup across all marketplace profiles
gologin-local-agent-browser batch ./marketplace-warmup.json \
  --targets ./all-seller-profiles.json \
  --concurrency 3 --name marketplace-warmup

# check which jobs succeeded
gologin-local-agent-browser jobs --kind batch --status completed
gologin-local-agent-browser jobs --kind batch --status failed

Geo-testing your own product

See how your website looks from different countries — does pricing show correctly? Do geo-redirects work?

# create profiles for each test region
gologin-local-agent-browser profile-create "Test US" --template geo --proxy-country us
gologin-local-agent-browser profile-create "Test DE" --template geo --proxy-country de
gologin-local-agent-browser profile-create "Test JP" --template geo --proxy-country jp

# open each, screenshot, compare
gologin-local-agent-browser open https://yoursite.com --profile us_id
gologin-local-agent-browser screenshot ./geo-us.png
gologin-local-agent-browser close

gologin-local-agent-browser open https://yoursite.com --profile de_id
gologin-local-agent-browser screenshot ./geo-de.png
gologin-local-agent-browser close

Browser interaction commands

All browser commands match the cloud Agent Browser CLI: snapshot, click, type, fill, find, tabs, cookies, storage-export, storage-import, eval, screenshot, pdf, back, forward, reload, wait, press, scroll, upload, and more. See the Agent Browser CLI command reference for the full list.

Aliases

Alias	Maps to
`goto`, `navigate`	`open`
`history`	`jobs`
`open-visible`	`open --visible`
`open-background`	`open --background`
`tabnew`	`tabopen`
`tabswitch`	`tabfocus`
`js`	`eval`
`key`	`press`
`scrollinto`	`scrollintoview`
`quit`, `exit`	`close`

Agent Browser CLI — cloud browser version
Gologin Web Access CLI — unified CLI (scraping + browser)
AI Skills — plug-and-play skills for Claude Code
Node.js SDK — programmatic profile management

npm package

gologin-local-agent-browser-cli

Source code

GologinLabs/gologin-local-agent-browser

Overview

Connect

CLI Tools

Integration Guides

When to use local vs cloud

Install

Credentials

Architecture

Quick start

Profile management

Use-case templates

Doctor diagnostics

Runbooks and batch execution

Single runbook

Batch execution

Jobs and history

Visibility controls

Use cases and examples

Warm up new accounts

LinkedIn outreach with persistent profiles

Manage multiple ad accounts

E-commerce and marketplace operations

Geo-testing your own product

Browser interaction commands

Aliases

npm package

Source code

​When to use local vs cloud

​Install

​Credentials

​Architecture

​Quick start

​Profile management

​Use-case templates

​Doctor diagnostics

​Runbooks and batch execution

​Single runbook

​Batch execution

​Jobs and history

​Visibility controls

​Use cases and examples

​Warm up new accounts

​LinkedIn outreach with persistent profiles

​Manage multiple ad accounts

​Social media management

​E-commerce and marketplace operations

​Geo-testing your own product

​Browser interaction commands

​Aliases

​Related

npm package

Source code

When to use local vs cloud

Install

Credentials

Architecture

Quick start

Profile management

Use-case templates

Doctor diagnostics

Runbooks and batch execution

Single runbook

Batch execution

Jobs and history

Visibility controls

Use cases and examples

Warm up new accounts

LinkedIn outreach with persistent profiles

Manage multiple ad accounts

Social media management

E-commerce and marketplace operations

Geo-testing your own product

Browser interaction commands

Aliases

Related