> ## Documentation Index
> Fetch the complete documentation index at: https://docs.screenframed.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI Auth Profiles

Record, refresh, test, list, and delete authenticated browser sessions for private captures.

Auth profile commands use Playwright locally to record browser cookies and localStorage, then store that browser state in ScreenFramed.

## Record a profile

```bash
screenframed auth login \
  --url https://app.example.com/login \
  --project prj_01K... \
  --name "Production dashboard"
```

Log in normally in the opened browser. When the page is authenticated, return to the terminal and confirm.

## Use the profile

```bash
screenframed capture https://app.example.com/dashboard \
  --auth-profile ap_01K... \
  --project prj_01K... \
  --device browser-macos \
  --output dashboard.png
```

## Refresh cookies

```bash
screenframed auth refresh ap_01K... \
  --url https://app.example.com/login
```

## Test a profile

```bash
screenframed auth test ap_01K... \
  --url https://app.example.com/dashboard
```

## List profiles

```bash
screenframed auth list
```

Filter by project:

```bash
screenframed auth list --project prj_01K...
```

## Delete a profile

```bash
screenframed auth delete ap_01K...
```

Auth profiles contain session material. Delete old profiles and use separate profiles for production, staging, and local tunnel domains.