Welcome to the Ensemble documentation. This guide covers everything you need to install, use, and contribute to Ensemble -- a macOS desktop application for managing Claude Code configurations.
For a high-level overview, see the project README.
| Document | Description |
|---|---|
| Installation Guide | System requirements, download, build from source, and verification |
| Usage Guide | Core concepts, features, and day-to-day workflows |
| Development Guide | Architecture, tech stack, project structure, and contributing |
- Install -- Download a pre-built release or build from source
- First-Time Setup -- Launch and import existing configurations
- Learn the Core Concepts -- Read about the five building blocks below
These are the primary modules you will work with inside Ensemble. Each section links to its detailed description in the Usage Guide.
| Concept | Description | Link |
|---|---|---|
| Skills | Claude Code skill modules (markdown files that give Claude specialized capabilities). Managed in ~/.ensemble/skills/ with global or project-level scope. |
Usage Guide -- Skills |
| MCP Servers | Model Context Protocol servers that extend Claude Code with additional tools and data sources. Configurations stored in ~/.ensemble/mcps/. |
Usage Guide -- MCP Servers |
| Scenes | Configuration bundles that combine multiple Skills, MCP Servers, and CLAUDE.md files into reusable templates. | Usage Guide -- Scenes |
| Projects | Link Scenes to local project directories so configurations can be deployed with one click. | Usage Guide -- Projects |
| CLAUDE.md | Context files that provide instructions to Claude Code at the global or project level. | Usage Guide -- CLAUDE.md |
| Feature | Description | Link |
|---|---|---|
| AI Auto-Classification | Use the Claude CLI to automatically categorize, tag, and assign icons to Skills, MCPs, and CLAUDE.md files. | Usage Guide -- Auto-Classification |
| Finder Integration | Install a Quick Action to open project folders with Claude Code directly from Finder's right-click menu. | Usage Guide -- Finder Integration |
| Terminal Support | Choose your preferred terminal (Terminal.app, iTerm2, Warp, or Alacritty) for launching Claude Code sessions. | Usage Guide -- Terminal Support |
| Trash & Recovery | Deleted items are moved to trash and can be restored from Settings. | Usage Guide -- Trash & Recovery |
If you want to contribute to Ensemble, the Development Guide covers:
- Architecture Overview -- Tauri 2 + React + Rust
- Tech Stack -- Frontend and backend dependencies
- Development Setup -- Prerequisites and getting started
- Project Structure -- Frontend and backend layout
- Building -- Development and production builds
- Contributing -- Code style, PR process, and issue reporting