After install, open a tiny repo and ask for a README summary to verify auth and tools.
Confirm the agent can list files without touching secrets directories.
Only then try a one-line edit with a clear accept/reject review.
If PATH or login fails, fix environment first—do not keep retrying prompts.
Keep a short checklist so teammates repeat the same smoke test.
Change one variable at a time so you know which step actually fixed the issue.
On managed devices, rule out policy blocks before blaming the app itself.
After it works, save a short checklist so the next incident takes minutes, not hours.
Export or screenshot the working setup so a reinstall can be restored quickly.
If it is still flaky, retry on a contrasting network such as phone hotspot to separate Wi-Fi from app faults.