CC Workshop

A macOS desktop application for managing Claude Code configurations -- Skills, MCP Servers, CLAUDE.md files, and Rules -- with visual organization, one-click project deployment, and Finder integration.

Overview

As your collection of Claude Code Skills, MCP Servers, CLAUDE.md context files, and Rule instruction files grows, managing them through manual file editing becomes tedious and error-prone. CC Workshop provides a native macOS interface to organize, bundle, and deploy these configurations to your projects.

Core workflow:

1. Import existing configurations from ~/.claude/ and ~/.claude.json
2. Organize with categories and tags (manual or AI-assisted)
3. Bundle related items into Scenes
4. Deploy Scenes to project folders via symlinks
5. Launch Claude Code from Finder with the right configuration

Features

Skills Management

• Import existing skills from ~/.claude/skills/
• Support for plugin-installed skills (from Claude Code plugins)
• Global or project-level scope control
• Usage statistics tracking from Claude Code logs

MCP Servers Management

• Import MCP configurations from ~/.claude.json (both user-scope and project-scope)
• Automatic tool discovery via MCP protocol
• Environment variable management
• Scope control (global/project) with automatic ~/.claude.json sync

CLAUDE.md Management

• Scan the filesystem for existing CLAUDE.md, CLAUDE.local.md, and .claude/CLAUDE.md files
• Import and centrally manage CLAUDE.md files
• Set a file as global context (~/.claude/CLAUDE.md)
• Distribute CLAUDE.md files to project directories
• Configurable distribution path: .claude/CLAUDE.md, CLAUDE.md, or CLAUDE.local.md

Rules Management

• Scan ~/.claude/rules/ and project .claude/rules/ directories for .md rule files
• Import and centrally manage Rule files; original filename is preserved (Claude Code indexes Rules by filename)
• Mark any number of Rules as global (~/.claude/rules/<filename>.md); edits propagate to the global copy immediately
• Distribute Rules to project directories at <project>/.claude/rules/<filename>.md
• Add multiple Rules to a Scene for batch deployment alongside Skills, MCPs, and CLAUDE.md

Marketplace

• Browse and install Skills from the community Skills catalog (skills.sh)
• Browse and install MCP Servers from the MCP Registry (registry.modelcontextprotocol.io)
• One-click install into your managed library, with auto-classification on install
• README previews, GitHub stars, and AI summaries in the detail panel

Scenes

• Bundle multiple Skills, MCP Servers, CLAUDE.md files, and Rules into reusable configuration sets
• One-click deployment to projects
• Scenes serve as templates for consistent project setup

Projects

• Associate local project folders with Scenes
• Sync configurations via symlinks (Skills) and .mcp.json (MCPs)
• Clear and re-sync configurations as needed

Organization

• Categories and tags for Skills, MCP Servers, CLAUDE.md files, and Rules
• Categories can be nested one level deep (subcategories indent under a parent in the sidebar)
• Drag to reorder categories and tags in the sidebar
• AI-powered auto-classification using the Claude CLI (claude command); choose between Opus, Sonnet, and Haiku
• Sidebar filtering by category and tag
• Group and sort options on every list page (by name, recency, or usage)

Finder Integration

• "Open with CC Workshop" right-click Quick Action for folders in Finder
• Automatically syncs the project's Scene configuration and launches Claude Code
• Configurable terminal: Terminal.app, iTerm2, Warp, Alacritty, or Ghostty
• Customizable launch command

Trash and Recovery

• Deleted Skills, MCPs, CLAUDE.md files, and Rules are moved to trash
• Recover deleted items from Settings

Installation

Prerequisites

• macOS 12.0 or later
• Claude Code installed

Download

Download the latest .dmg from the Releases page.

Build from Source

Requirements:

• Node.js 18+
• Rust 1.77+

git clone https://github.com/O0000-code/CC-Workshop.git
cd CC Workshop

npm install

# Development
npm run tauri dev

# Production build
npm run tauri build

Usage

Quick Start

1. Launch CC Workshop -- on first launch, it detects existing Skills and MCPs and offers to import them
2. Organize -- add categories and tags, or use Auto Classify
3. Create a Scene -- bundle related Skills, MCPs, CLAUDE.md files, and Rules
4. Add a Project -- select a folder and assign a Scene
5. Sync -- deploy the Scene's configuration to the project

Data Location

CC Workshop stores its data in ~/.cc-workshop/:

~/.cc-workshop/
├── data.json           # Application data (skills, MCPs, scenes, projects, categories, tags, rules)
├── settings.json       # User preferences
├── skills/             # Managed skill directories
├── mcps/               # MCP configuration files (.json)
├── claude-md/          # CLAUDE.md files (each in its own subdirectory)
├── rules/              # Rule files (each in its own subdirectory)
├── backups/            # Timestamped backups from import operations
└── trash/              # Deleted items (recoverable)
    ├── skills/
    ├── mcps/
    ├── claude-md/
    └── rules/

Tech Stack

• Frontend: React 18, TypeScript, Tailwind CSS 4, Zustand
• Backend: Tauri 2, Rust
• Build: Vite 6

Documentation

See the docs directory for detailed guides:

• Installation Guide
• Usage Guide
• Development Guide

License

MIT License

Contributing

Contributions are welcome. Please feel free to submit a Pull Request.