User Configuration Status

Display a comprehensive overview of Claude Code user configuration including health, storage, and quick links to management commands.

Task

Generate a unified status report covering all user configuration areas.

Step 1: Detect Platform and Paths

# Determine paths based on platform
if [[ "$OSTYPE" == "msys" || "$OSTYPE" == "cygwin" || "$OSTYPE" == "win32" ]]; then
  CLAUDE_DIR="$USERPROFILE/.claude"
  CLAUDE_JSON="$USERPROFILE/.claude.json"
  HOME_DIR="$USERPROFILE"
else
  CLAUDE_DIR="$HOME/.claude"
  CLAUDE_JSON="$HOME/.claude.json"
  HOME_DIR="$HOME"
fi

Step 2: Configuration Health Check

Check existence and validity of key configuration files:

File	Check	Status
~/.claude/	Directory exists	Yes/No
~/.claude/settings.json	Exists + valid JSON	OK/Missing/Invalid
~/.claude.json	Exists + valid JSON	OK/Missing/Invalid
~/.claude/.credentials.json	Exists (do NOT read contents)	OK/Missing
~/.claude/history.jsonl	Exists	OK/Missing

JSON Validation:

# Validate JSON files (check syntax only)
python -c "import json; json.load(open('$CLAUDE_DIR/settings.json'))" 2>/dev/null && echo "Valid" || echo "Invalid"

Step 3: Storage Summary

Get quick storage metrics (size only, not detailed breakdown):

# Get directory sizes
du -sh "$CLAUDE_DIR" 2>/dev/null
du -sh "$CLAUDE_DIR/projects" 2>/dev/null
du -sh "$CLAUDE_DIR/debug" 2>/dev/null
du -sh "$CLAUDE_DIR/file-history" 2>/dev/null
du -sh "$CLAUDE_DIR/plugins" 2>/dev/null

Step 4: MCP Server Count

Extract MCP server count from global config (without exposing sensitive data):

# Count MCP servers (keys only, no values)
python -c "
import json
from pathlib import Path
config_path = Path.home() / '.claude.json'
if config_path.exists():
    config = json.load(open(config_path))
    servers = config.get('mcpServers', {})
    print(f'MCP Servers: {len(servers)}')
    for name in servers.keys():
        print(f'  - {name}')
else:
    print('MCP Servers: 0 (no global config)')
"

Step 5: Session Statistics (Quick)

Get quick session counts:

# Count sessions
find "$CLAUDE_DIR/projects" -name "*.jsonl" -type f 2>/dev/null | wc -l

Step 6: Generate Status Report

Format the report:

# Claude Code Configuration Status

## Health Check
| Component | Status |
|-----------|--------|
| ~/.claude/ directory | ✅ OK |
| settings.json | ✅ Valid JSON |
| .claude.json (global) | ✅ Valid JSON |
| credentials | ✅ Present |
| history | ✅ Present |

## Storage Overview
| Area | Size |
|------|------|
| Total ~/.claude/ | 245 MB |
| Projects/Sessions | 180 MB |
| Debug logs | 12 MB |
| File history | 45 MB |
| Plugins | 8 MB |

## MCP Servers (3 configured)
- perplexity
- microsoft-learn
- firecrawl

## Quick Actions
- **Detailed storage:** `/user-config:storage`
- **Session stats:** `/user-config:session-stats`
- **Cleanup sessions:** `/user-config:cleanup-sessions`
- **Full cleanup:** `/user-config:prune`
- **Backup config:** `/user-config:backup` (coming soon)
- **Reset workflow:** `/user-config:reset` (coming soon)

Output Format

Present the status report in a clear, scannable format:

1. Health Check Table - Quick pass/fail for each config component
2. Storage Overview - Size breakdown by category
3. MCP Servers - List of configured servers (names only)
4. Quick Actions - Links to relevant management commands

Notes

• Privacy: Never display contents of credentials, tokens, or API keys
• Performance: Keep checks lightweight (no deep scanning)
• Cross-platform: Use Python pathlib for path handling when possible
• Delegation: For detailed breakdowns, refer users to specific commands

Related Commands

• /user-config:storage - Detailed storage breakdown with recommendations
• /user-config:session-stats - Session statistics and trends
• /user-config:prune - Comprehensive cleanup
• /user-config:audit - Deep health audit with drift detection