Installation
Plexus ships as a signed desktop app — download the build for your platform, install it like any other native app, and it keeps itself current after that.
The button picks the right build for your OS automatically; use the platform menu on it to choose another. Prefer to pick by hand? Every asset is listed below.
The download button routes through a lightweight redirect that counts an anonymous total-download tally before forwarding you to the file on GitHub — no account, no personal data, no cookies. See our Privacy Policy.
Download
Every installer lives on the public releases page:
https://github.com/CodedWords/plexus-releases/releases
Open the latest release and grab the asset that matches your platform from the sections below. Filenames carry the version (shown here as <version>, e.g. 0.1.0).
macOS
Plexus publishes separate builds for Apple Silicon and Intel — pick the one that matches your Mac.
| Mac | Download |
|---|---|
| Apple Silicon (M1 and later) | Plexus_<version>_aarch64.dmg |
| Intel | Plexus_<version>_x64.dmg |
Open the .dmg, drag Plexus into Applications, then launch it from there.
Linux
Linux builds are x86_64 (amd64) only, in two formats. The .deb suits Debian/Ubuntu-based distros; the .AppImage is a portable single-file binary that runs anywhere.
| Format | Download |
|---|---|
| Debian/Ubuntu package | Plexus_<version>_amd64.deb |
| Portable AppImage | Plexus_<version>_amd64.AppImage |
Install the .deb:
sudo apt install ./Plexus_<version>_amd64.deb
Or run the AppImage directly:
chmod +x Plexus_<version>_amd64.AppImage
./Plexus_<version>_amd64.AppImage
For desktop notifications on Linux, install notify-send (libnotify-bin on Debian/Ubuntu). It's optional — Plexus runs fine without it.
Windows
Windows ships a signed installer for x64.
| Format | Download |
|---|---|
| Installer | Plexus_<version>_x64_en-US.msi |
Run the .msi and follow the prompts. Plexus is added to the Start menu when it finishes.
Verify prerequisites
Plexus drives the Claude Code CLI and Git, so both must be installed and on your PATH. After installing, confirm them from a terminal:
claude --help
git --version
If claude isn't found, Requirements explains how Plexus locates it and the agent.programPath override. For pull-request features you connect a git provider (GitHub or Bitbucket) inside the app — no extra CLI to install. See Connections.
Staying up to date
Plexus updates itself — you don't need to revisit the releases page for future versions.
- It checks for a new release on launch and every ~30 minutes while it's open.
- When one is available, you get a one-click Install & restart, or Install when idle — which applies the update automatically once all your sessions finish, so a running agent is never interrupted. It waits for a short countdown (which you can cancel) before restarting.
- You can also check on demand from Settings → About → Check for updates.
- You're prompted once per new version — no repeated nagging.
- Every update is signature-verified before it's applied, so a tampered build won't install.
Need to reinstall or roll back manually? Download the installer for any version from the releases page and run it over your existing install.
Installed? Head to Getting started to add a repository and run your first session.