CLACOROO
EN IT
Download

Installation

CLACOROO ships native installers for macOS, Windows and Linux. This page covers downloading the right file and installing it. CLACOROO is signed with an Apple Developer certificate, so macOS just asks for confirmation the first time. Windows SmartScreen may show a warning because the installer doesn’t have an EV certificate yet.

Before you install

You need:

  • Claude Code installed and reachable from your shell PATH. CLACOROO is a UI on top of Claude Code, not a replacement.
  • Node.js 18 or later. Claude Code itself needs it; CLACOROO uses it to invoke the CLI on your behalf.

If you don’t have Claude Code yet, install it from claude.com/claude-code first.

Download

Open the Download page. Pick the installer for your platform and architecture:

PlatformFile(s)
macOS Apple SiliconCLACOROO-x.y.z-arm64.dmg
macOS IntelCLACOROO-x.y.z-x64.dmg
Windows installerCLACOROO Setup x.y.z.exe (x64 + arm64)
Windows portableCLACOROO x.y.z.exe (x64, no installer)
Linux universalCLACOROO-x.y.z.AppImage
Debian / Ubuntuclacoroo_x.y.z_amd64.deb
Fedora / RHELclacoroo-x.y.z.x86_64.rpm

Each download button points to the latest GitHub release, so you always get a current build.

macOS

If you use Homebrew, one command installs CLACOROO and clears the first-launch security prompt for you:

brew install --cask maxymize/clacoroo/clacoroo

This taps maxymize/clacoroo and installs the latest build for your architecture (Apple Silicon or Intel) automatically. Update later with:

brew update && brew upgrade --cask clacoroo

brew update refreshes the cask definition first (so Homebrew sees the new version), then brew upgrade installs it.

Because the cask removes the download quarantine flag during install, you skip the “unidentified developer” warning entirely. If you’d rather download manually, use the .dmg instead — see below.

Manual install (.dmg)

  1. Double-click the downloaded .dmg
  2. Drag CLACOROO into your Applications folder
  3. Double-click CLACOROO to open it
  4. macOS shows a one-time dialog: “CLACOROO” is an app downloaded from the internet. Are you sure you want to open it? — click Open
  5. From now on, CLACOROO opens like any other app

Apple Silicon vs Intel

If you have a Mac with an Apple chip (M1 and later), pick the arm64 build. On an Intel Mac, pick x64. The wrong one will refuse to run or will run under Rosetta 2 with no benefit.

Windows

  1. Double-click CLACOROO Setup x.y.z.exe
  2. Windows SmartScreen shows “Windows protected your PC” — click More info then Run anyway
  3. Pick the install location (or accept the default) and click Install
  4. CLACOROO opens on first launch and the shortcut lands on your Start menu and desktop

Portable

  1. Double-click CLACOROO x.y.z.exe
  2. Same SmartScreen warning — More info then Run anyway
  3. The app runs without installing anything; no Start menu entry, no Add/Remove Programs

The portable build is useful when you can’t install software on the machine, or when you want to keep CLACOROO on a USB stick.

x64 vs arm64

The installer bundles both x64 and arm64 binaries and picks the right one for your machine automatically. The portable build is x64 only.

Linux

AppImage (universal)

  1. Make the file executable: chmod +x CLACOROO-x.y.z.AppImage
  2. Double-click, or run it from a terminal: ./CLACOROO-x.y.z.AppImage
  3. Optionally integrate it with your desktop using a tool like AppImageLauncher

.deb (Debian, Ubuntu, derivatives)

sudo dpkg -i clacoroo_x.y.z_amd64.deb
sudo apt -f install   # in case of missing dependencies

After install you find CLACOROO in your application launcher.

.rpm (Fedora, RHEL, openSUSE)

sudo rpm -i clacoroo-x.y.z.x86_64.rpm
# or, on Fedora:
sudo dnf install ./clacoroo-x.y.z.x86_64.rpm

After install

  1. Open CLACOROO
  2. The onboarding tour walks you through the main sections
  3. Connect your Claude account from Settings (or, alternatively, add an Anthropic API key) — see Claude account
  4. Add your first marketplace — see Quick start · 3 · Add a marketplace

Updating

CLACOROO checks for updates on launch and shows a banner when a new version is available.

  • macOS / Windows: download the new installer from the Download page and run it — your settings and CLACOROO state are preserved.
  • Linux: same idea — download the new .AppImage/.deb/.rpm and replace the previous one.

CLACOROO never updates itself silently; you stay in control of when the new version lands.

Uninstalling

  • macOS — drag CLACOROO from Applications to the Trash. Optional cleanup: remove ~/Library/Application Support/CLACOROO/.
  • Windows — Settings → Apps → CLACOROO → Uninstall (or run the installer again and choose Uninstall). The portable build needs no uninstall; just delete the .exe.
  • Linux (.deb) — sudo apt remove clacoroo
  • Linux (.rpm) — sudo rpm -e clacoroo (or sudo dnf remove clacoroo)
  • Linux (AppImage) — just delete the .AppImage

Uninstalling CLACOROO does not touch your Claude Code configuration — every file in ~/.claude/ stays where it is, exactly as Claude Code expects.

Troubleshooting

  • “claude not found” toast on first launch. CLACOROO can’t find the claude binary on your PATH. See Troubleshooting.
  • macOS still refuses to open after clicking Open. Check System Settings → Privacy & Security; there’s an Open Anyway button near the bottom.
  • Windows SmartScreen blocks the installer with no “Run anyway” link. A group policy disabled it. Disable SmartScreen temporarily in Settings → Privacy & Security → Windows Security, or contact your IT admin.
  • Linux AppImage doesn’t open with a double-click. Some desktops require AppImageLauncher; install it and try again.