Intelligent AI-powered Claude Code configuration made effortless
Transform your Claude Code setup from hours of manual work to minutes of AI-powered automation
🎯 One command to rule them all • 🤖 AI-powered intelligence • 🛡️ Safe & reliable • 📈 Production ready
- 🚀 About CACI
- ✨ Key Features
- 🔧 Installation
- 📖 Quick Start
- 🎯 How It Works
- 📋 Example Workflow
- 🏗️ Development
- 📁 Project Structure
- 🤝 Contributing
- 📄 License
- 📞 Support
CACI (Code Assistant Configuration Interface) is a production-ready command-line interface tool that revolutionizes the Claude Code setup experience. Instead of manually selecting from hundreds of components, CACI uses Google's Gemini AI to analyze your project requirements and intelligently recommend the most relevant configuration components.
Setting up Claude Code optimally requires:
- 📊 Understanding 100+ agents, 150+ commands, 25+ MCPs, and 30+ hooks
- 🤔 Knowing which components work best for your specific project
- ⏰ Hours of manual research and configuration
- 🔄 Trial and error to find the right combination
CACI transforms this complex process into a simple, intelligent workflow:
- 🤖 AI Analysis: Gemini 2.5 Pro understands your project needs
- 🎯 Smart Recommendations: Get the top 10 most relevant components per category
- ⚡ One Command Setup: Complete configuration in minutes, not hours
- 🛡️ Safe Operations: Automatic backup and restore capabilities
Harness Google Gemini 2.5 Pro to analyze your project requirements and recommend the perfect Claude Code configuration
Parse and understand 100+ agents, 150+ commands, 25+ MCPs, and 30+ hooks from your component pool
Intuitive menu-driven CLI with colorful terminal output and smart defaults
Automatic backup creation and restore functionality - never lose your existing configuration
Full iteration history with comparison tools and one-click rollback capabilities
Native installation via NPM or containerized execution with Docker support
| ✅ | All CLI Commands | configure, init, update, reset, history |
| ✅ | AI Integration | OpenRouter API recommendations fully functional |
| ✅ | Configuration Management | Backup, restore, and apply operations |
| ✅ | Iteration Tracking | Complete history and comparison system |
| ✅ | Comprehensive Testing | 35 tests passing with full coverage |
| ✅ | CI/CD Pipeline | Automated testing, security scanning, and publishing |
Current Status: 🚀 Production-ready (83% complete, 5/6 stories implemented)
| 🟢 Node.js | Version 18 or higher | Download |
| 🔑 Google API Key | Required for AI recommendations | Get API Key |
| 📄 Components Definition | components.json in project root | Defines available Claude Code components |
# Set your Google API Key
export GOOGLE_API_KEY="your_google_api_key_here"The fastest way to get started
# Recommended: Use directly without installation
npx code-assistant-config-interface configure
# Or install globally
npm install -g code-assistant-config-interface
# Verify installation (if installed globally)
caci --versionContainerized execution with zero setup
# Pull the latest Docker image
docker pull elad12390/caci:latest
# Run CACI with your project mounted
docker run --rm \
-v $(pwd):/workspace \
-e OPENROUTER_API_KEY="$OPENROUTER_API_KEY" \
elad12390/caci:latest configure
# Or build locally
docker build -t caci ./caci
docker run --rm \
-v $(pwd):/workspace \
-e OPENROUTER_API_KEY="$OPENROUTER_API_KEY" \
code-assistant-config-interface configureGet up and running in 30 seconds
# 1. Navigate to your project directory
cd /path/to/your/project
# 2. Configure your Claude Code environment
npx code-assistant-config-interface configure
# 3. That's it! Your project is now optimally configured 🎉All commands are fully functional and production-ready
| Command | Description | Status |
|---|---|---|
npx code-assistant-config-interface configure |
Run the complete AI-powered configuration workflow | ✅ Ready |
caci init |
Initialize new configuration (alias for configure) | ✅ Ready |
caci update |
Update existing configuration (alias for configure) | ✅ Ready |
caci reset |
Restore from previous backup | ✅ Ready |
caci history |
View configuration iteration history | ✅ Ready |
caci --help |
Show detailed help information | ✅ Ready |
caci --version |
Display current version (v1.1.8) | ✅ Ready |
# Specify custom project directory (if installed globally)
caci configure --project-dir /path/to/project
# View help for specific commands
npx code-assistant-config-interface configure --help
caci history --help
# Check your configuration history
caci history
# Rollback to previous configuration
caci resetCACI automates the entire Claude Code configuration lifecycle through an intelligent 6-step process
|
Parses your |
Interactive CLI prompts gather your project details Languages • Frameworks • Complexity • Experience |
|
Google Gemini 2.5 Pro analyzes requirements against component pool Smart Recommendations • Optimal Configurations |
Automatically creates backup of existing |
|
Applies selected components to your Claude Code environment Seamless Integration • Ready to Use |
Saves complete configuration state for future reference History • Comparison • Rollback |
Here's what happens when you run npx code-assistant-config-interface configure:
$ npx code-assistant-config-interface configure
🔧 CACI (Code Assistant Configuration Interface) v1.0.0
=======================================================
📁 Project directory: /home/user/my-awesome-project
🚀 Starting Claude Code Configuration Workflow...
🔍 Parsing components.json file...
✅ Successfully parsed 102 agents, 158 commands, 29 hooks, and 25 MCPs
📝 Collecting user requirements...
? What type of project are you working on?
❯ Web Application
API/Backend Service
Data Science/ML
Mobile Application
Desktop Application
Other
? What programming languages are you using? (Select multiple)
◉ JavaScript/TypeScript
◉ Python
◯ Java
◯ Go
◯ Rust
? What frameworks/libraries are you using? React, FastAPI, PostgreSQL
? How would you describe your project's complexity?
◯ Simple (basic functionality)
❯ Medium (moderate features)
◯ Complex (advanced architecture)
? What's your experience level with Claude Code?
◯ Beginner
❯ Intermediate
◯ Advanced
🤖 Using AI to recommend components based on your requirements...
✅ Successfully generated AI recommendations
🎯 Recommended Components:
📋 Agents: react-expert, python-developer, api-designer, database-specialist
⚡ Commands: test-runner, code-formatter, deploy-helper, debug-assistant
🔗 MCPs: github-integration, postgres-tools, docker-manager
🎣 Hooks: pre-commit-linter, auto-formatter, test-validator
💾 Checking for existing .claude folder...
📦 Creating backup: .claude.backup.2025-08-21T20-52-36-897Z
✅ Successfully backed up existing configuration
⚙️ Applying new configuration...
├── Installing agents... ✅ 4/4 completed
├── Setting up commands... ✅ 4/4 completed
├── Configuring MCPs... ✅ 3/3 completed
└── Installing hooks... ✅ 3/3 completed
🕒 Saving iteration history...
✅ Successfully saved iteration 2025-08-21T20-52-36-897Z
🎉 Configuration completed successfully!
📋 Iteration ID: 2025-08-21T20-52-36-897Z
📊 Applied: 4 agents, 4 commands, 3 MCPs, 3 hooks
✨ Your Claude Code project is now optimally configured!
Next steps:
• Run 'caci history' to view configuration details
• Use 'caci reset' to restore previous configuration if needed
• Your Claude Code environment is ready for productive development!your-project/
├── .claude/ # Claude Code configuration (managed by CACI)
│ ├── agents/ # AI agent configurations
│ ├── commands/ # Custom command definitions
│ ├── mcps/ # Model Context Protocol integrations
│ └── hooks/ # Lifecycle hooks
├── .configurator/ # CACI tracking data (created automatically)
│ ├── iterations/ # Configuration history
│ └── backups/ # Automatic backups
├── components.json # Available components definition (required)
├── your-source-code/ # Your actual project files
└── ...
claude-code-configurator/
├── caci/ # Main CLI package
│ ├── src/ # TypeScript source code
│ │ ├── analyzer/ # Component analysis & AI recommendations
│ │ ├── manager/ # Configuration management & backup
│ │ ├── tracker/ # Iteration history & comparison
│ │ ├── integration/ # End-to-end workflow orchestration
│ │ └── cli/ # Command-line interface
│ ├── tests/ # Comprehensive test suite (35 tests)
│ ├── bin/ # CLI executable
│ ├── Dockerfile # Container configuration
│ └── package.json # NPM package definition
├── .github/workflows/ # CI/CD pipeline
│ ├── ci.yml # Main testing pipeline
│ ├── security.yml # Security scanning
│ ├── e2e.yml # End-to-end testing
│ ├── publish-npm.yml # NPM publishing
│ └── publish-docker.yml # Docker publishing
└── README.md # This file
| 🧪 | Test Coverage | 35 comprehensive tests covering all modules |
| 🔒 | Type Safety | Full TypeScript implementation with strict checking |
| ✨ | Code Quality | ESLint, Prettier, and automated formatting |
| 🔄 | CI/CD | Testing across Node.js 18, 20, 22 on Ubuntu, macOS, Windows |
| 🛡️ | Security | Automated vulnerability scanning and dependency updates |
# 1. Clone and setup
git clone https://github.com/elad12390/claude-code-configurator.git
cd claude-code-configurator/caci
# 2. Install dependencies
npm install
# 3. Set up environment
export GOOGLE_API_KEY="your_api_key_here"| Command | Description | Use Case |
|---|---|---|
npm run build |
TypeScript compilation | Prepare for production |
npm test |
Run all 35 tests | Verify functionality |
npm run test:watch |
Watch mode testing | Development testing |
npm run test:coverage |
Coverage report | Quality assurance |
npm run lint |
Code linting | Code quality |
npm run format |
Code formatting | Code consistency |
npm run dev |
Run from source (ts-node) | Live development |
# Build and run with Docker
npm run docker:build # Build container
npm run docker:run # Run in container
# Test different environments
docker run --rm -v $(pwd):/workspace -e OPENROUTER_API_KEY="$OPENROUTER_API_KEY" code-assistant-config-interface configureWe welcome contributions! CACI is an open-source project that benefits from community involvement.
| 🐛 | Bug Reports | Open an issue with detailed reproduction steps |
| 💡 | Feature Requests | Suggest new features with use cases and requirements |
| 🔧 | Code Contributions | Fork, develop, test, and submit a pull request |
| 📖 | Documentation | Improve README, code comments, or create tutorials |
| 🧪 | Testing | Help expand test coverage or test on different environments |
- 🎯 Code Quality: Follow TypeScript best practices, run
npm run lintandnpm run format - 🧪 Testing: Add tests for new features, ensure
npm testpasses - 📖 Documentation: Update README for new features or API changes
- 💬 Commit Messages: Use clear, descriptive commit messages
- 🔄 Pull Requests: Include description, link related issues, ensure CI passes
MIT License - Use, copy, modify, merge, publish, distribute, sublicense, and/or sell freely with attribution
| 📖 | Documentation | Check this README and inline code comments |
| 💬 | Issues | GitHub Issues for questions and support |
| 🔍 | Source Code | Well-structured and documented codebase for easy navigation |
| 📦 | NPM Package | caci on NPM |
| 🐳 | Docker Hub | elad12390/caci |
📈 Status: Production-ready (83% complete, 5/6 stories implemented)
🧪 Tests: 35 comprehensive tests with full coverage
📦 Version: v1.0.0 (Production Ready)
Made with ❤️ for the Claude Code community
Transform your Claude Code setup from hours of manual work to minutes of AI-powered automation
🚀 Get Started Now • 📖 Read the Docs • 🤝 Contribute