cct --health-check
cct --health        # Short alias
cct --verify        # Alternative alias
cct --check         # Another alias

┌───────────────────────┐
│  SYSTEM REQUIREMENTS  │
└───────────────────────┘
✅ Operating System     │ macOS 15.0 (compatible)
✅ Node.js Version      │ v22.11.0 (compatible)
✅ Memory Available     │ 16.0GB total, 8.5GB free (sufficient)
✅ Network Connection   │ Connected to Anthropic API
✅ Shell Environment    │ zsh (excellent autocompletion support)

┌─────────────────────┐
│  CLAUDE CODE SETUP  │
└─────────────────────┘
✅ Installation         │ v2.0.0 (globally installed)
✅ Authentication       │ Authenticated via OAuth ([email protected])
✅ Auto-updates         │ Auto-updates assumed enabled
✅ Permissions          │ Claude directory permissions OK

📊 Health Score: 28/30 checks passed (93%)

💡 Recommendations:
   • Add proper frontmatter (name, description) to agent files
   • Create .mcp.json file to configure MCP servers for your project

Recommended 4GB+ memory for optimal performance
Consider closing other applications

Cannot reach Anthropic API
Check your internet connection and firewall settings

Consider switching to Zsh for better autocompletion and features

Add proper frontmatter (name, description) to agent files
Example:
---
name: My Agent
description: Agent description
---

Create .mcp.json file to configure MCP servers for your project
Use: cct --mcp web-fetch

Create .claude/agents/ directory to organize your custom agents
Use: cct --agent frontend-developer

Fix JSON syntax errors in MCP configuration files
Validate with: jsonlint .mcp.json

Add missing command fields to MCP server configurations
Ensure all servers have a 'command' field

Would you like to run the Project Setup? (Y/n)

cct  # Interactive setup

# Fix agent syntax
vi .claude/agents/my-agent.md
# Add frontmatter:
# ---
# name: My Agent
# description: Description here
# ---

# Fix MCP config
vi .mcp.json
# Ensure valid JSON structure

# Fix permissions
chmod 755 .claude/
chmod 644 .claude/settings.json

# After installing Claude Code
cct --health-check

# Review results
# Fix any issues
# Re-run to verify fixes

# When experiencing issues
cct --health-check

# Identify problem areas
# Follow recommendations

# New team member setup
cct --health-check

# Ensure all requirements met
# Verify configuration
# Launch setup if needed

# Before deploying to production
cct --health-check

# Verify all configurations
# Ensure no warnings
# Document health score

# Monthly health check
cct --health-check

# Monitor degradation
# Proactive maintenance

# Verify installation
which claude
claude --version

# Reinstall if needed
npm install -g @anthropic-ai/claude-code

# Check authentication
cat ~/.claude.json

# Re-authenticate
claude login

# Clear old conversations
cct --setting retention/retention-7-days

# Optimize configuration
# Remove unused agents/commands

# Save health check output
cct --health-check > health-$(date +%Y%m%d).txt

# Track over time
ls -l health-*.txt

# Team policy: 90%+ health score required
cct --health-check
# If score < 90%, fix issues before proceeding

#!/bin/bash
# pre-commit-health-check.sh

HEALTH_OUTPUT=$(cct --health-check)
HEALTH_SCORE=$(echo "$HEALTH_OUTPUT" | grep -oP '\d+(?=%)')

if [ "$HEALTH_SCORE" -lt 90 ]; then
  echo "❌ Health score too low: $HEALTH_SCORE%"
  echo "Fix issues before committing"
  exit 1
fi

echo "✅ Health check passed: $HEALTH_SCORE%"

#!/bin/bash
# custom-health-check.sh

# Run standard health check
cct --health-check

# Add custom checks
echo "
Custom Checks:"

# Check for specific files
if [ -f "CLAUDE.md" ]; then
  echo "✅ CLAUDE.md exists"
else
  echo "❌ CLAUDE.md missing"
fi

# Check git repository
if [ -d ".git" ]; then
  echo "✅ Git repository initialized"
else
  echo "⚠️ No git repository"
fi

const { runHealthCheck } = require('claude-code-templates/src/health-check');

async function checkHealth() {
  const results = await runHealthCheck();
  console.log('Health Score:', results.healthScore);
  console.log('Recommendations:', results.recommendations);
}

checkHealth();