MultiClaude is a desktop workspace for running Claude Code in parallel. It lets you manage configurable terminal limits (preset or custom), keep project-scoped layouts, work with Git and GitHub without leaving the app, and receive task notifications across macOS, Windows, and Linux.

Built for developers who want the speed of Claude Code in a local terminal, but with better project switching, session persistence, repo operations, and intelligent terminal management than a raw shell setup.

• Parallel Claude Code Workspaces: Run with configurable terminal limits (2, 4, 9, or custom) in an auto-split grid that scales from focused single-terminal work to broad multi-agent runs.
• Project-Scoped Persistence: Each project keeps its own terminal layout, active sessions, and window state so context survives app restarts and repo switching.
• Smart Terminal Rendering: Three rendering modes (Performance/Balanced/Quality) with GPU controls and Claude-safe mode to optimize for speed or visual quality.
• Git + GitHub Inside the App: Visual git status, staging, branches, stash, history, GitHub auth via gh, remote repo creation, plus issue and pull request views.
• Notification Pipeline for Agent Runs: Detect complete, failed, and review-needed output patterns, then route alerts through native OS notifications, Telegram bots, or Discord webhooks.
• Desktop-First Terminal UX: Native PTY terminals with configurable rendering modes, drag-and-drop file paths, clipboard image path insertion, WSL-aware shell handling, cross-platform shell selection, and global shortcuts.
• Polished Local Distribution: Cross-platform installers, in-app auto-updates, changelog display, 7 UI themes + 5 terminal color palettes, and light/dark/system appearance without requiring a backend service.

Workflow Fit:

Feature Matrix:

Get the latest version from GitHub Releases.

• macOS: Run xattr -cr /Applications/MultiClaude.app in Terminal to remove quarantine, then open the app
• Windows: Click "More info" > "Run anyway" (for SmartScreen warning)
• Linux AppImage: Make executable with chmod +x MultiClaude-*.AppImage

# Install dependencies
npm install

# Run in development mode
npm run electron:dev

# Build for production
npm run build

src/
├── main/             # Electron main process
│   ├── terminal/     # PTY terminal management
│   ├── git/          # Git operations
│   ├── project/      # Project store
│   ├── notification/ # Telegram/Discord notifications
│   ├── clipboard/    # Clipboard image handling
│   ├── updater/      # Auto-update system
│   └── ipc/          # IPC handlers
├── renderer/         # React UI
│   ├── components/   # UI components
│   ├── hooks/        # Custom hooks
│   └── stores/       # Zustand stores
├── preload/          # Electron preload script
└── shared/           # Shared types and constants

• Node.js 24+

• GitHub CLI (gh) for GitHub integration

• Claude Code CLI for running Claude

• Windows: PowerShell (pwsh) is preferred; cmd is available as fallback

• Windows WSL: If using WSL shell, you must install a Linux distribution:

  wsl --install -d Ubuntu

  Error WSL_E_DISTRO_NOT_FOUND means WSL is installed but no distribution exists. Run the command above to fix.

  Note: WSL terminals take 2-5 seconds to start (cold start) due to Linux kernel initialization. Subsequent terminals are faster while WSL is running.

  Tip: UNC paths (e.g., \\wsl$\Ubuntu\home\user) are automatically converted to Linux paths for folder operations.

1. Add Project: Click the + button in the sidebar to add a project folder
2. Create Terminal: Click the + button in the terminal tab bar
3. Start Claude: Click "Start Claude" to invoke Claude Code in the active terminal
4. Git Integration: Use the Git panel in sidebar for staging, commits, branches

Note: All shortcuts work regardless of terminal focus. On macOS, Cmd replaces Ctrl (Alt shortcuts unchanged).

Configure in Settings > Notifications:

Detected events: Task Complete, Task Failed, Review Needed

Configure in Settings > Terminals:

See docs/ for detailed documentation:

• Project Overview & PDR
• System Architecture
• Code Standards
• Codebase Summary
• Tech Stack

npm run electron:dev    # Dev with hot reload
npm run build           # Production build
npm test                # Run tests
npm run test:coverage   # Coverage report
npm run typecheck       # Type checking

gh auth login -h github.com
# then run the repo-local Codex command:
$release beta

Supported targets: beta, main, current, or any real branch name.

Release flow:

1. Run $release <target> inside this repo.
2. Review the preview output, confirm the version/release type, and approve execution.
3. Re-run preview with the chosen version/release type when the command asks for them, then approve execution.
4. The command creates a draft GitHub release, pushes the tag, dispatches .github/workflows/release.yml via workflow_dispatch for the exact tag, and waits for CI assets to upload into that draft.
5. Publish the draft manually on GitHub after the assets land.

Notes:

• gh auth status must be valid before execution.
• The working tree must be clean before execution.
• npm run build and npm run build:ci remain useful for local packaging and CI verification.
• npm run release -- --target <target> and npm run release:execute -- ... mirror the new repo-local flow if you need a shell fallback.
• Legacy direct-publish scripts were renamed to publish:legacy* and are not the supported maintainer path.

MIT