Mac · diagnose + repair

Claude Desktop Doctor

Fixes the Claude desktop app when it freezes or goes to a white screen. Collects logs into one file you can send us, then offers a safe one-tap cache reset. About a minute.

Run the doctor

Two steps, about a minute total.

Download the script.
⬇ Download claude-doctor.sh

The download is gated by TWC Google SSO, so it knows it's you. It lands in your ~/Downloads folder.
Open Terminal and run it.
Use the copy button on the box below, paste into Terminal, press Return:
```
bash "$(ls -t ~/Downloads/claude-doctor*.sh | head -1)"
```
It collects logs into a zip on your Desktop, then asks if you want the safe fix. Answer the yes/no prompt and you're done.

First time using Terminal? Here's the friendly version.

Terminal is a built-in Mac app. It comes with every Mac, you don't install anything.

Press ⌘ + Space to open Spotlight (Apple's search box).
Type Terminal, press Return. A dark window opens, that's Terminal.
Hit the copy button on the gray box above, click into Terminal so it's active, paste with ⌘V, press Return.
Answer the one yes/no question at the end. That's it.

You can't break anything. The worst case is Terminal says "command not found" and waits for the next thing.

Need relief right now? When the window goes white, press Cmd + R (or View › Reload up top) to reload it fast instead of fully quitting. For big daily jobs, the regular Chat tab is steadier than Cowork.

What it does

Two parts. The first is read-only. The second only runs if you say yes.

1. Collect (read-only)

Bundles everything we need to see why the app is misbehaving into one zip on your Desktop:

System vitals — macOS version, chip, memory, free disk, and swap usage (heavy swap is the fingerprint of the app running out of memory).
App logs — the desktop app's own logs, including the Cowork agent logs where a long-task crash leaves a trace.
Crash reports — the app's crash recorder plus any macOS-level crash or hang reports for the renderer.
Cache footprint — sizes of the graphics and code caches, the usual suspect behind a white screen.

Your config is included with all secrets stripped out. Your chats, settings, and logins are never read.

2. Fix (only if you say yes)

Quits Claude, clears the stale graphics + code caches that cause the white screen, and reopens it.
Safe and reversible: the old caches are moved to a backup folder on your Desktop, not deleted. Your chats, settings, and logins are untouched.
The caches rebuild themselves on the next launch, so the first open afterward may be a few seconds slower. That's normal.

After it runs

Send us the zip.
Drag the claude-diagnostics-….zip from your Desktop into Slack to the Automation team. That's how we confirm the root cause.
If it comes back, re-run the same two steps. The script is safe to run as many times as you like.

Safety notes

The script is plain Bash, no admin password needed. Read it first if you want: /claude-doctor.sh.
Collecting is read-only. The fix only runs after you answer yes, and it moves caches to a backup rather than deleting them.
Your Claude chats live in your account, not in these caches, so they're never at risk.

← back to all tools