CC Mate - Configure your Claude Code without pain

A modern desktop application for managing Claude Code configuration files

Download Latest Release • Report Issues • Contributing Guide

💝 Sponsor

Thanks to PackyCode for sponsoring this project! PackyCode is a reliable and efficient API relay service provider, offering relay services for Claude Code, Codex, Gemini, and more. PackyCode provides special discounts for our software users: register using this link and enter the "cc-mate" promo code during recharge to get 10% off.

Want to become a sponsor? Contact https://x.com/randyloop

📸 Screenshots

Configuration Management

Usage Analytics

✨ Features

• 🔄 Multi-Configuration Support - Switch between multiple Claude Code configurations effortlessly
• ⚙️ MCP Server Management - Configure and manage Model Context Protocol (MCP) servers
• 🤖 Agent Management - Manage Claude Code agents and their settings
• 📋 Global Commands - Configure and organize global commands
• 📝 CLAUDE.md Integration - Read and write global CLAUDE.md memory files
• 🔔 Notifications
• 📊 Usage Analytics - Track and analyze your Claude Code usage

🚀 Quick Start

Install with Homebrew (macOS)

# Add the tap and install CC Mate
brew tap djyde/brew
brew install --cask ccmate

# Or install in one command
brew install --cask djyde/brew/ccmate

Download & Install

1. Download the latest release from randynamic.org/ccmate
2. Install the application for your platform:
   • macOS: Download the .dmg file and drag to Applications
   • Windows: Download the .exe installer and run it
   • Linux: Download the .AppImage or .deb package
3. Launch CC Mate from your applications folder

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details on:

• Setting up the development environment
• Building and testing the application
• Code style and guidelines
• Submitting pull requests

🐛 Troubleshooting

Common Issues

Application won't start

• Check if you have the latest version installed
• Verify system requirements are met
• Try running from terminal to see error messages

Configurations not loading

• Ensure Claude Code is installed and has been run at least once
• Check file permissions in ~/.claude/ directory
• Verify backup files weren't corrupted

Getting Help

• 📖 Documentation
• 🐛 Report Issues
• 💬 Discussions
• 📋 Contributing Guide

📄 License

This project is licensed under the GNU Affero General Public License v3.0.

See the LICENSE file for details.

---

Made with ❤️ by the community

⭐ Star this repo • 🐦 Follow updates