Skip to content

Repository files navigation

Claude Code Central (CCC)

🌟 Centralized AI Configuration Manager - Manage consistent AI assistant configurations across multiple software projects.

✨ Features

  • Centralized Storage - Single source of truth for all project configurations
  • Template System - Pre-configured templates for different project types
  • Symlink Management - Instant updates across all projects
  • Smart Detection - Automatically detects project type
  • Content Preservation - Preserves custom content during updates
  • Backup System - Automatic versioned backups
  • Agent Management - Add specialized AI agents to projects
  • Command System - Custom slash commands for Claude Code
  • Hook System - Automated workflows triggered by Claude Code events

🚀 Quick Start

# Run interactively
npx claude-code-central

# Or use specific commands
npx ccc setup              # Setup current project
npx ccc list               # List managed projects  
npx ccc update             # Update templates
npx ccc add-agent          # Add AI agents
npx ccc add-command        # Add custom commands
npx ccc add-hook           # Add automation hooks

📦 Installation

Using npx (recommended)

No installation needed! Just run:

npx claude-code-central

Global Installation

npm install -g claude-code-central
ccc

Install Global CCC

Make the ccc command and system commands available from anywhere:

npx ccc install

This installs:

  • The main CCC executable globally, allowing you to run ccc from any directory
  • System commands (ccc:*) that are available globally in Claude Code

📚 Commands

Command Description
setup Setup current project with central management
list List all managed projects
update Update project templates
unlink Remove central management from project
add-agent Add AI agent to current project
add-command Add project-specific command to current project
add-hook Add automation hook to current project
install Install global CCC executable and system commands
cleanup Clean up old backups
validate Validate system integrity
status Check current project status

🎨 Available Templates

  • 🌐 web-dev - Frontend frameworks & build tools
  • ✨ custom - Minimal starting point

📁 Project Structure

After setup, your project will have:

your-project/
├── .claude/              → Symlink to central storage
│   ├── settings.json     - Permissions and environment
│   ├── .mcp.json        - MCP server configurations
│   ├── commands/        - Custom commands
│   ├── agents/          - AI agents
│   └── hooks/           - Automation hooks
└── CLAUDE.md            → Symlink to central instructions

🔄 How It Works

  1. Central Storage: All configurations stored in ~/.ccc/storage/
  2. Symlinks: Projects link to central configurations
  3. Instant Updates: Changes propagate immediately
  4. Smart Merging: Custom content preserved during updates

🛠️ Development

# Clone the repository
git clone https://github.com/schlessera/ccc.git
cd ccc

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode
npm run dev

# Run tests
npm test

📝 Configuration Files

settings.json

Controls permissions and environment variables:

{
  "permissions": {
    "allow": ["npm:*", "git:*"],
    "deny": ["rm -rf"]
  },
  "env": {
    "NODE_ENV": "development"
  }
}

CLAUDE.md

Human-readable instructions for AI behavior and project standards.

.mcp.json

Model Context Protocol server configurations.

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide for details.

📄 License

MIT © Alain Schlesser

🔗 Links


Built with ❤️ for the AI-assisted development community

About

No description, website, or topics provided.

Resources

Contributing

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages