Quickstart

This page gets you from a clone to a running Conductor window with your first project open.

Prerequisites

Node.js ≥ 20 (developed on 22) and pnpm ≥ 9
Rust stable (developed on 1.95) — install via rustup
Platform build dependencies for Tauri — see the Tauri prerequisites guide. On macOS this is just the Xcode Command Line Tools (xcode-select --install).

Install dependencies

pnpm install

Run in development

pnpm tauri dev

The first pnpm tauri dev compiles the Rust dependencies (~30 s); subsequent runs are fast. Vite serves the frontend on port 1420 automatically and the Tauri shell opens a window.

First launch

On first launch Conductor scans ~/Code. Use the ⋯ button in the left sidebar (or the command palette → Change projects folder…) to pick a different folder.
Click a project to open a terminal tab rooted in that directory.
Split with ⌘D (right) or ⇧⌘D (down), drag the dividers to resize, and close panes with ⌘W.
Toggle the file tree with ⌘B; click a file to open it in Monaco (⌘S saves).
Press ⌘K any time to jump between projects, tabs, tasks, workspaces, and actions.

Build a release bundle

pnpm tauri build

Artifacts land in src-tauri/target/release/bundle/. For signed releases that the in-app updater can consume, see Releasing & auto-update.

Icons: src-tauri/icons/icon.png is a placeholder generated by node scripts/gen-icon.mjs. For a real release, drop in a 1024×1024 PNG and run pnpm tauri icon your-logo.png to generate every required size and format.

Next steps

Using Conductor — the day-to-day workflow.
Terminals & panes — splitting, search, and notification rings.
Workspaces — save your layout and reopen it later.