¶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

1. 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.
2. Click a project to open a terminal tab rooted in that directory.
3. Split with ⌘D (right) or ⇧⌘D (down), drag the dividers to resize, and close panes with ⌘W.
4. Toggle the file tree with ⌘B; click a file to open it in Monaco (⌘S saves).
5. 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.