A macOS desktop application for managing Claude Code configurations -- Skills, MCP Servers, and CLAUDE.md files -- with visual organization, one-click project deployment, and Finder integration.
As your collection of Claude Code Skills, MCP Servers, and CLAUDE.md context files grows, managing them through manual file editing becomes tedious and error-prone. Ensemble provides a native macOS interface to organize, bundle, and deploy these configurations to your projects.
Core workflow:
- Import existing configurations from
~/.claude/and~/.claude.json - Organize with categories and tags (manual or AI-assisted)
- Bundle related items into Scenes
- Deploy Scenes to project folders via symlinks
- Launch Claude Code from Finder with the right configuration
- Import existing skills from
~/.claude/skills/ - Support for plugin-installed skills (from Claude Code marketplace)
- Global or project-level scope control
- Usage statistics tracking from Claude Code logs
- 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.jsonsync
- Scan the filesystem for existing CLAUDE.md, CLAUDE.local.md, and
.claude/CLAUDE.mdfiles - 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, orCLAUDE.local.md
- Bundle multiple Skills, MCP Servers, and CLAUDE.md files into reusable configuration sets
- One-click deployment to projects
- Scenes serve as templates for consistent project setup
- Associate local project folders with Scenes
- Sync configurations via symlinks (Skills) and
.mcp.json(MCPs) - Clear and re-sync configurations as needed
- Categories and tags for Skills, MCP Servers, and CLAUDE.md files
- AI-powered auto-classification using the Claude CLI (
claudecommand) - Sidebar filtering by category and tag
- "Open with Ensemble" 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, or Alacritty
- Customizable launch command
- Deleted Skills, MCPs, and CLAUDE.md files are moved to trash
- Recover deleted items from Settings
- macOS 12.0 or later
- Claude Code installed
Download the latest .dmg from the Releases page.
Requirements:
- Node.js 18+
- Rust 1.77+
git clone https://github.com/O0000-code/Ensemble.git
cd Ensemble
npm install
# Development
npm run tauri dev
# Production build
npm run tauri build- Launch Ensemble -- on first launch, it detects existing Skills and MCPs and offers to import them
- Organize -- add categories and tags, or use Auto Classify
- Create a Scene -- bundle related Skills, MCPs, and CLAUDE.md files
- Add a Project -- select a folder and assign a Scene
- Sync -- deploy the Scene's configuration to the project
Ensemble stores its data in ~/.ensemble/:
~/.ensemble/
├── data.json # Application data (skills, MCPs, scenes, projects, categories, tags)
├── settings.json # User preferences
├── skills/ # Managed skill directories
├── mcps/ # MCP configuration files (.json)
├── claude-md/ # CLAUDE.md files (each in its own subdirectory)
├── backups/ # Timestamped backups from import operations
└── trash/ # Deleted items (recoverable)
├── skills/
├── mcps/
└── claude-md/
- Frontend: React 18, TypeScript, Tailwind CSS 4, Zustand
- Backend: Tauri 2, Rust
- Build: Vite 6
See the docs directory for detailed guides:
MIT License
Contributions are welcome. Please feel free to submit a Pull Request.