Sessions

Sessions are named browser contexts that carry independent state: cookies, localStorage, auth tokens, open tabs, and more. Multiple sessions can run simultaneously.

Default session

Commands without a --session flag use the default session automatically.

agent-browser open example.com    # uses "default" session

Named sessions

# Create/open a named session
agent-browser open https://app.example.com/login --session myapp

# Send subsequent commands to the same session
agent-browser snapshot --session myapp
agent-browser click @e3 --session myapp

Session list

agent-browser sessions

Lists all active sessions with their current URL and status.

Profiles

A profile is a directory that stores persistent browser data (cookies, localStorage, extensions, cache). Sessions share a profile by default. Use separate profiles to isolate accounts:

agent-browser open https://app.example.com --profile ./profiles/account-a
agent-browser open https://app.example.com --profile ./profiles/account-b

Session close

agent-browser close              # Close active session tab
agent-browser close --all       # Close all sessions