JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 41
  • Score
    100M100P100Q95302F
  • License MIT

Security and cleanup toolkit for Claude Code. Auto secret detection, 99.4% config reduction. CLI & MCP Server.

Package Exports

  • @light-merlin-dark/claude-code-helper
  • @light-merlin-dark/claude-code-helper/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@light-merlin-dark/claude-code-helper) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

 ██████╗ ██████╗██╗  ██╗
██╔════╝██╔════╝██║  ██║
██║     ██║     ███████║
██║     ██║     ██╔══██║
╚██████╗╚██████╗██║  ██║
 ╚═════╝ ╚═════╝╚═╝  ╚═╝

Configuration management and security toolkit for Claude Code
CLI & MCP Server • Always-on secret detection • Dry-run by default

Why CCH?

  • CLI-First: Simple commands Claude can run directly - no MCP complexity required
  • Safe by Default: Every cleanup previews changes before execution
  • Intelligent Cleanup: 99.4% reduction capability (14MB → 84KB)
  • Security Focused: Automatic secret detection on every command
  • Global Analysis: Analyzes entire Claude workspace, not just individual projects

Install

# As global CLI (recommended)
npm install -g @light-merlin-dark/claude-code-helper

# Or as package
npm install @light-merlin-dark/claude-code-helper

Quick Start

CLI:

# Clean your config (dry-run by default)
cch clean                  # Preview what will be removed
cch clean --execute        # Actually perform cleanup

# Remove empty projects
cch clean projects -e      # Execute after preview

# Security audit
cch --audit                # Analyze config health
cch --mask-secrets-now     # Emergency secret removal

With Claude:

Tell Claude to run commands directly:

  • "Run cch clean to preview cleanup"
  • "Use cch --audit to analyze my config"
  • "Run cch --mask-secrets-now to secure my config"

Core Commands

Clean:

cch clean              # Remove large pastes, images, dangerous permissions
cch clean projects     # Remove empty or accidental projects
cch clean history      # Clear all conversation history
cch clean help         # See all options

# All commands preview first, use --execute to run
cch clean -e           # Execute after preview

Security:

cch --audit                # Full config analysis
cch --audit --stats        # Quick summary
cch --mask-secrets-now     # Emergency secret masking

Permissions:

cch -lp                # List current permissions
cch -add "docker"      # Add permission (auto-expands to docker:*)
cch -ap                # Apply permissions to all projects
cch -dp                # Discover common permissions

Settings:

cch fix-settings       # Fix Claude settings validation errors
cch fix-settings -e    # Apply fixes across all projects

Fixes validation errors in bulk:

  • Tool names: "git status" → "Git status"
  • Wildcards: "Bash(command )" → "Bash(command :)"
  • MCP tools: "mcp__tool__name" → "Mcp__tool__name"

MCP Server (Optional)

For advanced integrations, install as MCP server:

cch install            # Install as MCP server
cch uninstall          # Remove MCP server

Most users only need the CLI. MCP provides programmatic access to the same functionality.

Available tools include:

  • doctor - Comprehensive diagnostics and health checks
  • audit - Security analysis and config health
  • backup/restore - Configuration backup management
  • view-logs - Filter and search CCH logs
  • reload-mcp - Reload MCP configurations
  • discover-mcp-tools - Analyze MCP tool usage across projects
  • list-mcps - Show all MCPs in workspace
  • get-mcp-stats - MCP usage statistics
  • Bulk operations: add-permission, remove-permission, add-tool, remove-tool

Ask Claude to use them:

"Use CCH to reload the aia MCP"
"Run CCH diagnostics on my setup"
"Show me recent error logs"
"Audit my configuration for issues"

Safety Features

  • Always-On Secret Detection: Automatic scanning on every command
  • Dry-Run by Default: All clean commands preview before execution
  • Emergency Response: cch --mask-secrets-now for immediate action
  • Blocked Commands: Prevents rm -rf /, fork bombs, disk formatting
  • Automatic Backups: Created before any changes
  • Smart Expansion: docker → docker:* automatically

Configuration

~/.claude.json         # Claude's main config (managed by Claude)
~/.cch/                # CCH configuration directory
  ├── permissions.json # Your base permissions
  ├── preferences.json # User preferences
  ├── state.json       # Usage tracking
  └── backups/         # Configuration backups

Default safe permissions when starting fresh:

  • make:*, npm run:*, npm test:*
  • git status, git diff:*, git log:*

Development

# Clone and setup
git clone https://github.com/light-merlin-dark/claude-code-helper.git
cd claude-code-helper
npm install

# Build and test
npm run build       # Build for production
npm run dev         # Run in development mode
bun test            # Run all tests
bun test:watch      # Watch mode

Comprehensive test coverage: unit tests, integration tests, E2E CLI tests, MCP validation, and performance benchmarks.

License

MIT

Built by @EnchantedRobot