Installation

Plexus is available for macOS, Windows, and Linux.

Download

Visit the GitHub Releases page and download the appropriate version for your platform:

macOS

Windows

Linux

macOS Installation

1. Download the .dmg file for your Mac
2. Open the DMG file
3. Drag Plexus to your Applications folder
4. Open Plexus from Applications

First Launch Security

When you first open Plexus, macOS may show a security warning because the app is not notarized. To allow Plexus to run:

1. Go to System Settings > Privacy & Security
2. Scroll down to find the message about Plexus
3. Click Open Anyway

Alternatively, right-click the app and select "Open" from the context menu.

Windows Installation

1. Download the .exe installer
2. Run the installer and follow the prompts
3. Launch Plexus from the Start Menu

Linux Installation

AppImage

chmod +x Plexus-*.AppImage
./Plexus-*.AppImage

Debian/Ubuntu

sudo dpkg -i Plexus-*.deb

Fedora/RHEL

sudo rpm -i Plexus-*.rpm

Build from Source

If you prefer to build from source:

Prerequisites

• Node.js 20 or later
• pnpm 10 or later

Steps

# Clone the repository
git clone https://github.com/JinmuGo/plexus.git
cd plexus

# Install dependencies
pnpm install

# Build the application
pnpm build

# Run in development mode
pnpm dev

# Or run the production build
pnpm start

Create Distributable

# Build for your current platform
pnpm make:release

The built application will be in the dist/ directory.

Automatic Hook Installation

When Plexus launches for the first time, it automatically installs hook scripts for supported AI agents:

• Claude Code: Hooks added to ~/.claude/settings.json
• Cursor: Hooks configured in Cursor's settings
• Gemini CLI: Hooks set up for Gemini integration

No manual configuration is required. Just start using your AI agents as normal, and Plexus will detect them automatically.

Verify Installation

1. Launch Plexus
2. Open a terminal and start an AI agent (e.g., claude)
3. The agent should appear in the Plexus dashboard within seconds

Data Locations

Plexus stores data in the following locations:

Updating

To update Plexus:

1. Download the latest version from GitHub Releases
2. Install it over the existing version

Your data and settings will be preserved.

Uninstalling

macOS

1. Move Plexus from Applications to Trash
2. Optionally remove data: rm -rf ~/.plexus ~/Library/Application\ Support/plexus

Windows

1. Uninstall from Settings > Apps
2. Optionally remove data: rmdir /s %USERPROFILE%\.plexus %APPDATA%\plexus

Linux

# Remove the application
sudo apt remove plexus  # or rpm -e, etc.

# Optionally remove data
rm -rf ~/.plexus ~/.config/plexus

Next Steps

Now that Plexus is installed, continue to the Quick Start guide to learn the basics.