cozempic Doctor (Claude Code Health Check)
Diagnoses your Claude Code config and sessions to pinpoint common failure causes, with an optional auto-fix.
UtilitiesBeginner★ 369⑂ 36AI score 8/10Last updated: Jul 3, 2026
What it does
Runs cozempic doctor to health-check your Claude Code environment, covering:
- Trust dialog hang — Windows resume bug caused by a
.claude.jsontrust entry - Missing hooks trust flag — absent
hasTrustDialogHooksAcceptedmakes hooks fail silently (v2.1.51+) - Agent model mismatch — subagents not inheriting the team lead's model, causing 403s
- Corrupted
.claude.json— truncated/invalid file from concurrent write races - Corrupted tool_use / orphaned tool_result blocks — classic sources of 400 API errors
- Zombie team dirs, oversized sessions, stale
.bakbackups, disk footprint
Detected problems can be repaired with cozempic doctor --fix.
Who it's for
- Claude Code users hitting mysterious 400/403 errors or hangs
- Anyone wondering why their hooks never fire
- Windows users whose sessions won't resume
- Users who want to reclaim disk space from old sessions and backups
Examples
- "Claude Code keeps returning 400 errors — find out why" → detects corrupted tool_use or orphaned tool_result blocks
- "My hooks aren't running" → checks the missing trust flag and repairs it with
--fix - "How much disk is Claude Code using? Clean up old backups" → disk usage report plus stale
.bakcleanup
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/Ruya-AI/cozempic/HEAD/plugin/skills/cozempic-doctor/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the plugin/skills/cozempic-doctor folder from the GitHub repo Ruya-AI/cozempic into my ~/.claude/skills/cozempic-doctor/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/Ruya-AI/cozempic.git && mkdir -p ~/.claude/skills && cp -r cozempic/plugin/skills/cozempic-doctor ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal.
- Clone the repo:
git clone https://github.com/Ruya-AI/cozempic.git - Create the skills folder:
mkdir -p ~/.claude/skills - Copy the skill:
cp -r cozempic/plugin/skills/cozempic-doctor ~/.claude/skills/ - This skill needs the
cozempicCLI. Follow the repo README to install it, then verify withcozempic --version. - Restart Claude Code and ask "run a health check on my Claude Code setup" to trigger the skill.
- Back up
~/.claude.jsonbefore running the auto-fix mode.
View source on GitHub ↗License: MIT