Installation & Setup
Plexi runs on macOS (Apple Silicon or Intel, macOS 12 Monterey or later).
Install
Plexi needs Git and a Rust toolchain. If Rust is missing, the installer first asks whether to install it with rustup. A cold build takes several minutes.
Open Terminal and run:
curl -fsSL https://plexiapp.com/install | shThe installer clones Plexi into ~/.plexi-src, builds it on your Mac, copies
Plexi.app to /Applications, installs the plexi CLI in /usr/local/bin, and
adds shell completions. It may ask for your password to write the CLI. Launch
Plexi from Applications or Spotlight.
Plexi does not request Accessibility permission on first launch. Its app bundle declares camera and microphone permissions for video rooms, which macOS requests only when a feature uses them.
Teach Your Agent
Plexi is built to be driven by coding agents. If you use Claude Code, Cursor, Codex, or any agent that supports skills, install the Plexi skill so your agent knows the CLI:
npx skills add ianjamesburke/plexi-skillsRun it in a project to install for that project, or add -g for a global install. The skill documents the plexi CLI surface — panes, apps, contexts, notifications — so your agent can drive Plexi without trial and error. To update it later, run npx skills update.
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 — build and run Plexi apps