A comprehensive management package for Claude Code configurations with global settings, custom commands, MCP tools, and an upcoming modern desktop application.
Transform Claude Code configuration management from manual file editing to streamlined workflows, starting with a powerful script-based package and evolving into an intuitive desktop application.
Available Now: Complete configuration management through automated scripts
- Global Settings: Secure, optimized Claude Code configuration
- 30+ Custom Commands: Pre-built commands organized by category (testing, git, analysis, docs, deployment, maintenance)
- MCP Tools: Essential Model Context Protocol servers (GitHub, Memory, Filesystem, Fetch, Sequential Thinking)
- Hook Templates: Automation for formatting, testing, and notifications
- Safety Features: Comprehensive backup system and easy rollback
- Cross-Platform: Works on Windows, macOS, and Linux
# Clone the repository
git clone https://github.com/puya/claude-code-manager.git
cd claude-code-manager
# Run the setup script
chmod +x setup.sh
./setup.sh
# That's it! Claude Code is now supercharged! 🚀setup.sh- Main installation script with comprehensive backup system, interactive selection, and multiple modesarchive/setup-validation.sh- Legacy pre-installation validation (functionality now built into setup.sh)archive/restore-backup.sh- Legacy rollback script (functionality now available via./setup.sh --restore)
claude-code-manager/
├── README.md # This file
├── setup.sh # Enhanced setup script with interactive interface
├── claude-resources/ # All Claude configuration resources
│ ├── global-settings/
│ │ ├── settings.json # Global Claude Code settings
│ │ └── mcp-config.json # MCP server configurations
│ ├── commands/ # Global custom commands
│ │ ├── testing/
│ │ │ ├── test.md # Run project tests
│ │ │ ├── test-coverage.md # Generate coverage reports
│ │ │ └── lint-fix.md # Auto-fix linting issues
│ │ ├── git/
│ │ │ ├── commit-msg.md # Generate commit messages
│ │ │ ├── code-review.md # Perform code reviews
│ │ │ └── fix-github-issue.md # Fix GitHub issues
│ │ ├── analysis/
│ │ │ ├── explain.md # Explain code files
│ │ │ ├── refactor.md # Refactor code
│ │ │ └── security-audit.md # Security analysis
│ │ ├── docs/
│ │ │ ├── docs.md # Generate documentation
│ │ │ └── changelog.md # Update changelogs
│ │ ├── deployment/
│ │ │ ├── deploy.md # Deploy applications
│ │ │ └── dependency-audit.md # Check dependencies
│ │ └── maintenance/
│ │ ├── cleanup.md # Project cleanup
│ │ ├── performance-audit.md # Performance analysis
│ │ └── session-start.md # Start dev sessions
│ ├── hooks/
│ │ └── templates/
│ │ ├── auto-format.toml # Auto-format on file edit
│ │ ├── pre-commit.toml # Pre-commit validation
│ │ ├── test-runner.toml # Auto-run tests
│ │ └── notification.toml # Desktop notifications
│ └── mcp-tools/
│ ├── essential-mcp-setup.sh # Install essential MCP servers
│ ├── advanced-mcp-setup.sh # Install advanced MCP servers
│ └── mcp-servers-list.md # Complete MCP servers reference
├── setup-scripts/ # Modular setup system
│ └── modules/ # Core setup modules
└── docs/ # Documentation
├── QUICK-START.md # Getting started guide
├── ADVANCED-USAGE.md # Advanced configurations
├── TROUBLESHOOTING.md # Common issues & solutions
├── COMMUNITY-RESOURCES.md # Links to all external resources
└── development/ # Development planning docs
- Comprehensive permissions - Bash, Edit, Read, Write, Create, WebFetch allowed
- Security safeguards - rm, sudo, and dangerous commands blocked
- Smart ignore patterns - node_modules, .git, build artifacts automatically ignored
- Privacy settings - Telemetry disabled by default
/test- Run all project tests with coverage/git:commit-msg- Generate conventional commit messages/explain [file]- Get detailed code explanations/security-audit- Comprehensive security analysis/deploy [env]- Deploy to any environment/docs- Auto-generate documentation- And many more organized by category!
- GitHub - Repository management and issue handling
- Memory - Persistent context across sessions
- Filesystem - Safe file system access
- Sequential Thinking - Complex problem solving
- Fetch - Web content retrieval
- Puppeteer - Browser automation (optional)
- Auto-formatting - Python (Black), JavaScript (Prettier) on file save
- Pre-commit validation - Run checks before commits
- Test automation - Auto-run tests on test file changes
- Desktop notifications - Get notified when long tasks complete
- Works across all your projects automatically
- No repetitive setup - configure once, use everywhere
- Team-shareable project-specific overrides
- Testing & QA - Comprehensive testing workflows
- Git & GitHub - Version control automation
- Code Analysis - Refactoring, security, performance
- Documentation - Auto-generated docs and guides
- Deployment - Environment management
- Maintenance - Cleanup and optimization
- Essential tools for basic workflows
- Advanced tools for specialized needs
- Easy installation with automated setup scripts
# Testing & Quality
/test # Run all tests
/test-coverage # Generate coverage report
/lint-fix # Fix linting issues
# Git & GitHub
/git:commit-msg # Generate commit message
/git:code-review # Review recent changes
/fix-github-issue 123 # Fix specific GitHub issue
# Code Analysis
/explain src/app.js # Explain code file
/refactor src/old.js # Refactor code
/security-audit # Security analysis
# Documentation & Deployment
/docs # Generate documentation
/deploy production # Deploy to production
/cleanup # Clean up projectThe new setup script offers multiple modes for different use cases:
# Interactive mode (default) - Beautiful interface with component selection
./setup.sh
# Preview mode - See what would be installed without making changes
./setup.sh --preview
# Dry run - Full simulation of installation process
./setup.sh --dry-run
# Accept all - Install everything with defaults (great for automation)
./setup.sh --accept-all
# Restore from backup - Interactive backup selection and restoration
./setup.sh --restore
# Get help - Show all available options
./setup.sh --help- Awesome Claude Code - Comprehensive resource collection (200+ items!)
- Official Documentation - Anthropic's official Claude Code docs
- Best Practices - Anthropic's proven patterns
- Claudia GUI - Beautiful desktop interface for Claude Code
- Claude Swarm - Multi-agent coordination system
- Claude Flow - Enterprise AI orchestration platform
- Claude Squad - Multi-session tmux management
- CCManager - Clean TUI session manager
- CCUsage - Token usage and cost analysis
- Claude Usage Monitor - Real-time usage monitoring
- Claude Command Suite - 90+ professional commands
- Claude Sessions - Session tracking system
- MCP Install Guide - Easy MCP server installation
- Claude on Rails - Ruby on Rails framework
- Claude Hub - GitHub integration
- VS Code Extension - Claude Config Manager
Edit ~/.claude/settings.json to modify global preferences:
code ~/.claude/settings.jsonCreate new commands in ~/.claude/commands/:
echo "# My Custom Command\nYour command instructions here" > ~/.claude/commands/my-command.md# Essential tools (included in setup)
./claude-resources/mcp-tools/essential-mcp-setup.sh
# Advanced tools (optional)
./claude-resources/mcp-tools/advanced-mcp-setup.shCopy hook templates to your projects:
cp claude-resources/hooks/templates/*.toml .claude/settings.toml# List available backups
./setup.sh --list-backups
# Restore from specific backup
./setup.sh --restore backup-name
# Interactive restore (choose from list)
./setup.sh --restore- Read the guides in the
docs/folder - Check the troubleshooting guide for common issues
- Explore community resources for advanced patterns
- Use the built-in help:
./setup.sh --help
- Set up Tauri + React project structure
- Implement basic UI framework
- Create file system operations
- Build settings validation
- Complete configuration management UI
- Add MCP server management
- Implement import/export functionality
- Add backup/restore features
- Add project detection and management
- Implement settings inheritance
- Create multi-project dashboard
- Add project templates
- Build community resource discovery
- Implement one-click installation
- Add resource management features
- Create contribution workflow
- Integrate ecosystem tools
- Add tool deployment and monitoring
- Implement enterprise features
- Add performance analytics
- No feature bloat or unnecessary complexity
- Focus on essential functionality
- Clean, intuitive interface design
- All data stored locally
- No cloud dependencies for core features
- Privacy-focused approach
- Fast startup times (<2 seconds)
- Minimal memory usage (<100MB)
- Responsive UI interactions
- Native look and feel on all platforms
- Consistent functionality across OS
- Platform-specific optimizations
- Claude Code installed and working
- Bash shell (Git Bash on Windows, Terminal on macOS/Linux)
- Node.js 18+ (optional, for MCP tools)
# Clone the repository
git clone https://github.com/puya/claude-code-manager.git
cd claude-code-manager
# Method 1: Validate first (recommended)
./setup-validation.sh
./setup.sh
# Method 2: Direct install
./setup.sh- Global settings with secure permissions and optimized performance
- 30+ custom commands for testing, git, analysis, docs, and deployment
- MCP tools for GitHub, memory, filesystem, and more
- Hook templates for automation
- Comprehensive backup system for safe configuration
# Restore your previous configuration
./restore-backup.sh# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
# Install Node.js (for frontend development)
# Download from https://nodejs.org/
# Install Tauri CLI
cargo install tauri-cli# Install dependencies
npm install
# Start development server
npm run tauri dev
# Build for production
npm run tauri build- Streamlined Claude Code setup in <5 minutes
- Safe installation with zero configuration loss
- 30+ useful commands immediately available
- Community adoption and feedback collection
- 1,000+ active users within 6 months of release
- <2s startup time, <100MB memory usage
- 4.5+ average user rating
- 90% task completion rate
We welcome contributions from the community! Please read our Contributing Guidelines before getting started.
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests for new functionality
- Submit a pull request
- Follow Rust and JavaScript best practices
- Write comprehensive tests
- Document all public APIs
- Follow semantic versioning
This project is licensed under the MIT License - see the LICENSE file for details.
- Documentation: Check the
docs/directory - Issues: Report bugs on GitHub Issues
- Discussions: Join community discussions
- Email: support@claude-code-manager.com
- Anthropic: For creating Claude Code
- Tauri Team: For the excellent framework
- Community: For feedback and contributions
- Contributors: All the amazing people who help build this tool
See ROADMAP.md for detailed development plans and future features.
Built with ❤️ by the Claude Code community