DocsOverview

Getting started

Install Plexus, add a repository, and run your first agent session in under a minute.

Install

Download the build for your platform from the home page, or grab the latest release directly:

bash

# macOS (Homebrew)
brew install --cask plexus

# Linux (.deb)
sudo dpkg -i plexus_amd64.deb

Windows builds ship as a signed .msi installer. All artifacts are published on the GitHub releases page.

First launch

On first run, Plexus checks that the agent CLI is available on your PATH. If it isn't, you'll see an actionable prompt:

Claude Code CLI not found on PATH. Install the claude command, then restart Plexus.

Add a project

Click Add repository in the tree, or use the command palette. Point Plexus at any local git repo — no daemon, no server-side config.

bash

# the repo just needs to be a normal git checkout
git clone https://github.com/you/your-app.git
# then "Add repository" → select the folder

Start a session

With a project selected, hit ⌘N for New session. Plexus creates a worktree, checks out a fresh branch, and launches the agent. Type your task into the Agent tab and watch it work.

Each session is fully isolated — running three in parallel won't touch your main working tree.

Requirements

macOS 12+, Windows 10+, or a modern Linux distribution
git 2.30+ with worktree support
A supported agent CLI (e.g. Claude Code) on your PATH

← Previous

Introduction

Architecture