doctor

Overview

This skill uses the cozempic doctor tool to validate Claude Code configuration and sessions. It detects issues such as trust dialog hangs, oversized sessions, stale backups, and overall disk usage to aid troubleshooting.

How This Skill Works

Invoke the Bash tool cozempic doctor to perform checks for trust dialog hangs, oversized sessions, stale backups, and disk usage. If issues are detected, you can auto-fix them with cozempic doctor --fix.

When to Use It

• When Claude Code shows a trust dialog hang related to the .claude.json trust entry.
• When sessions appear oversized or trigger compaction issues.
• When disk space is consumed by stale backups (.bak files).
• When you need a quick health audit of Claude Code's storage footprint.
• When troubleshooting Claude Code configuration or session problems.

Quick Start

1. Step 1: Run cozempic doctor to perform health checks.
2. Step 2: Review results for trust dialog hangs, oversized sessions, stale backups, and disk usage.
3. Step 3: If issues are detected, run cozempic doctor --fix to auto-fix them.

Best Practices

• Run doctor regularly as part of maintenance to catch issues early.
• Use cozempic doctor --fix to auto-fix detected problems.
• After fixes, review the trust entry in .claude.json and re-test for hangs.
• Clean up stale backups (.bak files) to reclaim disk space.
• Check disk usage after fixes to confirm resolution and stability.

Example Use Cases

• Running cozempic doctor reveals a trust dialog hang; run with --fix to resolve the issue.
• Doctor reports oversized sessions; perform cleanup or session management to reduce size.
• Identified stale backups consuming disk space and removed them to reclaim space.
• A full disk usage check shows Claude Code's storage footprint; plan upgrade or cleanup as needed.
• After applying fixes, re-run doctor to verify that issues are resolved.

Frequently Asked Questions