browser_session

Developer-mode browsers: a separate Chrome the companion launches, without the user’s logins.

Developer-mode browsers: a separate Chrome the companion launches, without the user’s logins. Only launch one when the user explicitly asks for it, or when a tool reported that an operation needs developer mode (heap snapshots, Lighthouse, raw CDP). For everyday work use the user’s shared tabs. Each named context is a separate Chrome with its own persistent profile; several can run in parallel. launch/close/status take a context (default “default”); contexts lists saved profiles; delete removes a stopped context’s profile.

Everyday work happens in the user’s shared tabs. The dashboard’s Settings page decides whether a separate browser may open at all (Only when needed, Always, Never).

Parameters

action · enum · required

One of: launch, status, close, contexts, delete.

context · string

Context name, e.g. “work” or “personal” (default “default”)

all · boolean

close: close every running context

url · string

Initial URL for launch

headless · boolean

Launch without a window (watch it via the live view URL in browser_status)

chromePath · string

 

args · string[]

Extra Chrome switches

devtools · boolean

Open Chrome DevTools for every tab so the user can watch the standard panels while you work (default: true unless headless)

proxy · string

Proxy server for this browser, e.g. “http://proxy:8080” or “socks5://127.0.0.1:1080”

extensions · string[]

Unpacked extension directories to load into this browser

downloadDir · string

Where downloads land (default ~/.browspark/downloads/<context>)

Example

Launch the default context

{
  "action": "launch"
}

Launch a named, headless context behind a proxy

{
  "action": "launch",
  "context": "scraper",
  "headless": true,
  "proxy": "socks5://127.0.0.1:1080",
  "url": "https://example.com"
}

Close everything

{
  "action": "close",
  "all": true
}