Troubleshooting

Chromium is missing

Install the browser managed by Playwright:

playwright install chromium

The prompt box never appears

Refresh the saved login and finish any sign-in or browser challenge in the window that opens:

sengpt --login

The browser profile is already in use

Close every other Chromium window started by Sengpt. A persistent browser profile can only be used by one browser process at a time.

An invisible session is challenged

Show the browser once, complete the challenge, and then retry normally:

sengpt --headed

On Linux, invisible sessions require Xvfb; Sengpt does not use true Chromium headless mode there.

Report a selector failure

If a ChatGPT interface change breaks Sengpt, open an issue with the command and error message. Never include cookies, credentials, or browser profile data.