Installation & Setup

Plexi runs on macOS (Apple Silicon or Intel, macOS 12 Monterey or later).

Install

Open Terminal and run:

curl -fsSL https://plexiapp.com/install | sh

You’ll be asked for your password. The script installs Plexi.app to /Applications, sets up the plexi CLI in /usr/local/bin, and adds shell completions. Launch Plexi from Applications or Spotlight.

Prefer to install manually?

Download the .dmg from the GitHub releases page, open it, and drag Plexi to your Applications folder.

Note: the install script also sets up the CLI and shell completions automatically. If you install manually, open Plexi after dragging it to Applications — it will prompt you to install the CLI on first launch.

On first launch, Plexi will request Accessibility permission. This is required for context-aware features.

Your First Session

Plexi opens with a single terminal pane. From there:

Action	Shortcut
Split horizontally	`⌘D`
Split vertically	`⌘⇧D`
Navigate panes	`⌘H` / `⌘J` / `⌘K` / `⌘L`
Close pane	`⌘W`
Rename pane	`⌘R`

Build Channels

Plexi ships three channels. Each is a fully isolated instance with its own binary, profile directory, and app bundle — you can run all three simultaneously.

Channel	Binary	Profile
Stable	`plexi`	`~/.plexi/`
Beta	`plexi-beta`	`~/.plexi-beta/`
Alpha	`plexi-alpha`	`~/.plexi-alpha/`

Next Steps

Quick Note — open a persistent scratch pane from anywhere
Panes & Pages — understand the layout model
Apps — run sandboxed apps inside Plexi