# Sessions And Authentication

## Named Sessions

```bash
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:

```bash
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

```bash
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

```bash
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.