skills/agent-browser/references/sessions-auth.md

Sessions And Authentication

Named Sessions

agent-browser --session site1 open https://site-a.com
agent-browser --session site2 open https://site-b.com
agent-browser --session site1 snapshot -i
agent-browser session list
agent-browser --session site1 close

Auth Vault

Pipe passwords via stdin to avoid shell history exposure:

echo "pass" | agent-browser auth save github --url https://github.com/login --username user --password-stdin
agent-browser auth login github
agent-browser auth list
agent-browser auth show github
agent-browser auth delete github

State Files

agent-browser open https://app.example.com/login
agent-browser snapshot -i
agent-browser fill @e1 "$USERNAME"
agent-browser fill @e2 "$PASSWORD"
agent-browser click @e3
agent-browser wait --url "**/dashboard"
agent-browser state save auth.json
agent-browser state load auth.json

Session Persistence

agent-browser --session-name myapp open https://app.example.com/login
agent-browser close
agent-browser --session-name myapp open https://app.example.com/dashboard
agent-browser state list
agent-browser state clear myapp
agent-browser state clean --older-than 7

Set AGENT_BROWSER_ENCRYPTION_KEY to encrypt stored state at rest.