Requirements

To run Plexus you need the Claude Code CLI and Git installed on your machine; a connected git provider and, on Linux, notify-send unlock the rest.

Claude Code CLI

Plexus runs every session through the Claude Code CLI; it does not bundle its own agent. Install Claude Code and confirm the claude command works in a terminal:

claude --help

Plexus finds claude on your PATH at startup, so a standard install needs no configuration. There's no API key to enter — your existing Claude Code authentication is handed through to each session.

See Settings for where this lives.

Prefer the native install?

Nothing in Plexus requires it, but Claude Code also ships a standalone build that doesn't depend on Node or npm. Run claude install from a terminal to switch an existing install over, or on Windows run this in PowerShell:

irm https://claude.ai/install.ps1 | iex

Anthropic's setup guide is at https://code.claude.com/docs/en/setup.

Git

Git must be installed and on your PATH. Plexus uses it to detect repositories, create and remove worktrees, switch branches, and compute diffs. Any standard Git install satisfies this.

Git providers (for pull requests)

Pull-request features — opening PRs, reading status, and checking CI — need a connected git provider, either GitHub or Bitbucket. There's nothing to install: open Settings → Git ▸ Providers and click Connect, then approve the one-click sign-in in your browser. The gh CLI is not required. Everything else (sessions, editing, local Git) works without connecting. See Connections.

notify-send (Linux, optional)

On Linux, Plexus uses notify-send for native desktop notifications — for instance when an agent needs your input. Without it, Plexus falls back to its in-app notifications, so it's purely optional. macOS and Windows use their native notification systems and need nothing extra.

Supported platforms

Ready to get it running? See Install.