Skip to main content
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 whenUse cloud when
Profile warmupQuick stateless scraping
Account login flowsNo local machine available
Cookie accumulationParallel sessions at scale
Social / marketplace actions inside a persistent profileOne-off browser tasks
Agent loops that reuse the same local identityNo need for persistent profile state

​
Install

npm install -g gologin-local-agent-browser-cli
Requires Node.js >= 20.

​
Credentials

VariableRequiredDescription
GOLOGIN_TOKENYes (for open)Gologin API token
GOLOGIN_PROFILE_IDOptionalDefault profile ID
GOLOGIN_DAEMON_PORTOptionalDaemon port (default: 44778)
GOLOGIN_HEADLESSOptionaltrue or false (default: false)
GOLOGIN_EXECUTABLE_PATHOptionalPath to Orbita executable
GOLOGIN_TMPDIROptionalGologin temp/profile directory
Config file: ~/.gologin-local-agent-browser/config.json

​
Architecture

Two parts:
  1. gologin-local-agent-browser CLI — parses commands, auto-starts daemon
  2. 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.
CommandDescription
profilesList 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
TemplatePurpose
linkedinWarmup-oriented leadgen profile
ads / facebookAds operator profile with strong account isolation
smmShared-access social profile for cookie/storage handoffs
scrapingAutomation-oriented local profile
geoGeo-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

FlagBehavior
--visible / --headedStart Orbita with a visible window
--background / --headlessRun without visible window
DefaultFalls 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

​
Social media management

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

AliasMaps to
goto, navigateopen
historyjobs
open-visibleopen --visible
open-backgroundopen --background
tabnewtabopen
tabswitchtabfocus
jseval
keypress
scrollintoscrollintoview
quit, exitclose

npm package

gologin-local-agent-browser-cli

Source code

GologinLabs/gologin-local-agent-browser