Ensemble
Health Pass
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 10 GitHub stars
Code Warn
- fs module — File system access in generate-ico.cjs
- fs module — File system access in generate-ico.js
Permissions Pass
- Permissions — No dangerous permissions requested
This is a macOS desktop application that provides a graphical user interface for managing Claude Code configurations. It helps you organize, bundle, and deploy Skills, MCP Servers, and CLAUDE.md files to your local projects via symlinks and configuration files.
Security Assessment
Overall Risk: Medium. The application is designed to read, modify, and symlink files within your local filesystem, specifically scanning `~/.claude/` directories and distributing configuration files to your project folders. The automated rule-based scan found filesystem access warnings limited to two icon-generation scripts (`generate-ico.cjs` and `generate-ico.js`), which appear to be standard build tools rather than malicious payloads. No dangerous permissions, hardcoded secrets, or excessive network requests were detected. However, because the tool's core functionality inherently requires reading and modifying local configuration files and environment variables, you should inspect exactly what it writes.
Quality Assessment
The project is actively maintained, with its most recent push occurring today. It uses the highly permissive and standard MIT license. Community trust is currently low; while the repository is active, it only has 10 GitHub stars, indicating a limited user base and minimal external code review.
Verdict
Use with caution. The tool is legitimate, actively maintained, and open-source, but its requirement to deeply manage and modify your local filesystem and Claude configuration files warrants a quick review of the code before deploying it to sensitive projects.
A macOS desktop app for managing Claude Code configurations — Skills, MCP Servers, and CLAUDE.md files
Ensemble
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.
Overview
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

Features
Skills Management
- 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
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.jsonsync
CLAUDE.md Management
- 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
Scenes
- 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
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, and CLAUDE.md files
- AI-powered auto-classification using the Claude CLI (
claudecommand) - Sidebar filtering by category and tag
Finder Integration
- "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
Trash and Recovery
- Deleted Skills, MCPs, and CLAUDE.md files 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/Ensemble.git
cd Ensemble
npm install
# Development
npm run tauri dev
# Production build
npm run tauri build
Usage
Quick Start
- 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
Data Location
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/
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:
License
MIT License
Contributing
Contributions are welcome. Please feel free to submit a Pull Request.
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found


