CLI Auth Profiles

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.