Installation

ClaudeWorks runs on macOS. Install from a DMG, or build from source.

Requirements

macOS 12 or later.
Claude Code already installed and signed in with claude login.
Optional: the GitHub CLI. With it, the marketplace gets 5,000 GitHub requests per hour instead of the anonymous 60.

ℹ

ClaudeWorks uses your existing Claude Code credentials. It does not create or manage API keys. Run claude login at least once before launching a profile.

Install from a release

Download the latest .dmg from the Releases page.
Open the DMG and drag ClaudeWorks to Applications.
On first launch, right-click the app, choose Open, and confirm. The app isn't notarized yet, so Gatekeeper flags it as unsigned. The full source is on GitHub if you want to audit it.
Optional: run gh auth login so the marketplace can hit the GitHub API at full rate.

Install from source

Build locally if you want to hack on ClaudeWorks or run a specific commit. Requires Node 20 or later and Electron 33.

git clone https://github.com/Mduffy37/claudeworks
cd claudeworks
npm install
npm run build
npm start

Use npm run dev for the Vite dev server with live-reload on the UI side.

What gets created

On first launch ClaudeWorks creates a few directories under your home folder:

~/.claudeworks/ holds profiles, teams, aliases, and logs.
~/.claudeworks/profiles/ contains a config directory per profile. Each one becomes a CLAUDE_CONFIG_DIR at launch time.
~/.claudeworks/bin/ holds the generated shell aliases. Add this directory to your PATH to use them.

Your existing ~/.claude/ and ~/.claude.json are not written to, with one exception. Installing or removing a plugin updates the shared cache at ~/.claude/plugins/. This is by design: profiles share the cache so updates propagate across all of them automatically.

Updating

ClaudeWorks checks for updates on launch and shows a notification when a new release is available. Download the new DMG and replace the app in Applications. Your profiles, teams, and aliases carry over.

Next → Quick Start