claude-orchestrator

Run Claude Desktop as multiple independent instances on macOS with claude-orchestrator. This tool enables users to manage separate profiles, accounts, sessions, and working directories without duplicating or altering the original application. Each instance operates from a unique data directory, ensuring that the app maintains its signature, notarization, permissions, and updater functionality.

Key Features

• Independent Instances: Launch several instances of Claude Desktop, each configured with its own profile, account, and session.

• Original App Integrity: claude-orchestrator launches the original, signed app, preventing any issues related to signature or permissions that custom copies might cause.

• Interactive Mode: Start the application without any arguments to access a user-friendly menu, allowing easy management of profiles and projects. Below is an example of using the interactive mode:

  claude-orchestrator
  

  You can view the status of each instance and access various options directly through the menu.

Quick Start Example

Set up separate accounts for work, school, and clients easily:

claude-orchestrator new work
claude-orchestrator new school
claude-orchestrator new client --workdir ~/workspace/client  # Optional project setup

claude-orchestrator signin work --exclusive  # Sign in to one account at a time
claude-orchestrator signin school --exclusive
claude-orchestrator signin client --exclusive

claude-orchestrator start work && claude-orchestrator start school && claude-orchestrator start client
claude-orchestrator agent --install   # Install menu bar icons to manage instances

Session Management

Easily manage Claude Code sessions across instances:

claude-orchestrator session list  # List all sessions across instances
claude-orchestrator session move <session_id> --to <target_instance>

Project Management

Keep projects synchronized across instances by maintaining a shared projects list. Projects can be imported from a JSON file to keep them organized and updated across all instances. The following commands assist with project management:

claude-orchestrator project add ~/workspace/api  # Add a project
claude-orchestrator project apply ~/config/projects.json  # Apply settings from a JSON file
claude-orchestrator project import --from default  # Import projects from the default setup

Why Use Claude Orchestrator?

The single Electron profile limitation of Claude Desktop can restrict the usability when managing multiple accounts. claude-orchestrator addresses this by allowing simultaneous operation of distinct sessions, enhancing productivity for professionals juggling multiple roles or clients.

System Requirements

• Requires macOS 13 (Ventura) or later.
• Original Claude Desktop application must be installed in /Applications.

To explore more functionalities, consult the comprehensive documentation available in the repository.