CC Mate - Configure your Claude Code without pain

April 3, 2026 ยท View on GitHub

A modern desktop application for managing Claude Code configuration files

Download Latest Release โ€ข Report Issues โ€ข Contributing Guide

License: AGPL v3 Homebrew Downloads

PackyCode 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.
AICodeMirror Thanks to AICodeMirror for sponsoring this project! AICodeMirror provides official high-stability relay services for Claude Code / Codex / Gemini CLI, with enterprise-grade concurrency, fast invoicing, and 24/7 dedicated technical support. Claude Code / Codex / Gemini official channels at 38% / 2% / 9% of original price, with extra discounts on top-ups! AICodeMirror offers special benefits for CCmate users: register via this link to enjoy 20% off your first top-up, and enterprise customers can get up to 25% off!

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

๐Ÿ“ธ Screenshots

Configuration Management

CC Mate Configuration Interface

Usage Analytics

CC Mate Analytics Dashboard

โœจ 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

๐Ÿ“„ 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