Architecture

Plexus is a Tauri desktop app: a Rust core for git and process management, a Vue 3 front end for the UI. It's deliberately thin — fast to start, light on memory, and entirely on your machine.

The big picture

The app is a three-pane orchestration shell: a project tree on the left, session tabs in the center, and an optional AI-summary sidebar on the right, plus a global dashboard across everything.

• Core (Rust / Tauri) — owns git operations, worktree lifecycle, and agent processes.
• UI (Vue 3 + Vite) — renders state and dispatches commands; never touches your repo directly.
• Agents — each runs as a child process scoped to its worktree.

Worktrees

A session maps one-to-one to a git worktree. This is what makes safe parallelism possible: agents edit independent checkouts of the same repo, so their changes never collide until you choose to integrate them.

# what Plexus does under the hood, roughly:
git worktree add .plexus/wt/fix-auth-redirect -b fix/auth-redirect
# → agent runs here, isolated from your main tree

The shell

Session views are split into tabs — Agent, Review, Explorer, and Git. Fixed-height chrome (40px title bar, 28px rows) and resizable, persisted panes keep the layout dense and predictable.

Local-first

There is no Plexus server. Everything — repos, keys, agent output — stays on your device. That's a deliberate privacy stance, and it's why the app stays fast.