🪄 cl-magic

Magic wrappers and utilities for Claude Code - because coding should be less boring

😅 The Developer Reality

When you open your codebase on Monday morning...

"Wait, who wrote this? Oh right... it was me at 3 AM"

---

After your 5th cup of coffee, Claude finally gets it...

"YES! Now I can finally have that free time... wait, there's another bug?"

---

Your AI teammate when you ask for "just a small feature"...

"Sure, let me just refactor your entire architecture real quick"

---

When the code actually works on the first try...

"✨ MAGIC ✨ (or is it just luck?)"

The truth? Repetitive coding tasks are boring. We need coffee. We want free time. That's why cl-magic exists.

🎯 Why cl-magic?

Tired of repetitive Claude Code workflows? cl-magic brings automation, custom commands, and delightful shortcuts to make AI pair programming actually enjoyable. Less repetition, more magic.

✨ Features

• 🚀 Custom Commands - Create reusable workflows for common tasks
• 🔄 Batch Operations - Process multiple files or tasks in one go
• 📝 Templates - Pre-built prompts and project structures
• ⚡ Smart Automation - Reduce manual intervention in repetitive tasks
• 🎨 Beautiful CLI - Intuitive and colorful command-line interface
• 🔧 Extensible - Easy to add your own magic commands

📦 Installation

npm install -g cl-magic

Or use with npx:

npx cl-magic <command>

Building from Source

# Clone the repository
git clone https://github.com/eliasbui/cl-magic.git
cd cl-magic

# Install dependencies
npm install

# Build TypeScript
npm run build

# Link locally (optional)
npm link

🚀 Quick Start

# Initialize cl-magic in your project
cl-magic init

# Run a magic command
cl-magic run <task>

# Get help
cl-magic --help

📖 Usage

Basic Commands

# Initialize configuration
cl-magic init

# Run a predefined task
cl-magic run refactor

# Create a new template
cl-magic template create

# Batch process files
cl-magic batch ./src/**/*.js

Example Workflows

Refactor multiple files:

cl-magic batch refactor ./src/components/*.jsx --style=functional

Generate documentation:

cl-magic docs generate --output=./docs

Run custom magic:

cl-magic magic your-custom-command

🎨 Configuration

Create a .clmagicrc.json in your project root:

{
  "templates": {
    "refactor": "Refactor this code to be more maintainable",
    "optimize": "Optimize this code for performance"
  },
  "defaults": {
    "verbose": true,
    "autoCommit": false
  }
}

🛠️ Available Commands

Command	Description
init	Initialize cl-magic in your project
run <task>	Execute a predefined task
batch <pattern>	Process multiple files
template <action>	Manage templates
magic <name>	Run custom magic commands
config	Manage configuration

📚 Documentation

For detailed documentation, visit our docs folder or check out:

• API Reference
• Contributing Guide
• Examples

🤝 Contributing

We love contributions! Check out our Development Guide to get started.

# Clone the repo
git clone https://github.com/eliasbui/cl-magic.git

# Install dependencies
npm install

# Build TypeScript
npm run build

# Watch mode for development
npm run dev

# Run locally
npm link
cl-magic --help

🐛 Issues

Found a bug or have a feature request? Open an issue

📝 License

MIT © Eliasbui

🙏 Acknowledgments

• Built with ❤️ for the Claude Code community
• Inspired by developers who are tired of repetitive tasks
• Special thanks to all contributors

🌟 Star History

If you find this project useful, please consider giving it a star! ⭐

---

Made with 🪄 by developers, for developers