Workbench

A desktop terminal manager built with Tauri v2 and Svelte 5. Add local project folders, and each project gets a tabbed workspace with real shell terminals, Claude Code + Codex integration, and git worktree support.

Installation

Download the latest release from the Releases page:

• macOS (Universal) — Workbench_x.x.x_universal.dmg

Open the .dmg and drag Workbench to your Applications folder.

macOS is the primary target. Linux and Windows support is planned.

Features

• Project sidebar — add, edit, remove, and reorder local project folders
• Tabbed workspaces — each project gets its own workspace with multiple terminal tabs
• Terminal splitting — horizontal and vertical panes with resizable grid layout
• Real shell terminals — native PTY sessions via portable-pty + xterm.js
• Claude Code integration — start new Claude sessions, resume previous ones, and view session history per project
• Codex integration — start and resume Codex sessions alongside Claude, with full session discovery
• Git worktree support — create and manage worktrees with isolated workspaces per branch
• Startup commands — auto-run commands when opening a project
• VS Code integration — open any project or worktree in VS Code
• Claude Code settings — view and edit Claude settings (user, project, local scopes) directly from Workbench
• Persistent config — projects and workspaces saved to ~/.workbench/

Stack

• Tauri v2 (Rust backend + webview)
• Svelte 5 (frontend, runes-based reactivity)
• xterm.js + portable-pty (terminal emulation)
• Tailwind CSS v4 + shadcn-svelte
• Bun (package manager)

Development

Prerequisites

• Rust (for Tauri backend)
• Bun (for frontend dependencies)
• macOS (primary development target)

Getting Started

bun install
bun run dev

This runs tauri dev, which starts the Vite dev server on port 1420 and opens the Tauri window.

Commands

Rust tests can be run separately:

cargo test --manifest-path src-tauri/Cargo.toml

Project Structure

src/                    # Svelte frontend
  lib/
    components/         # Shared UI components (shadcn-svelte)
    features/           # Feature modules (projects, workspaces, terminal, claude, worktrees)
    stores/             # Svelte context-based stores
    utils/              # Shared utilities
  types/                # TypeScript type definitions
src-tauri/              # Rust backend
  src/
    commands.rs         # Tauri IPC command handlers
    config.rs           # Project/workspace persistence
    codex.rs            # Codex session discovery and config
    claude_sessions.rs  # Claude session discovery and hooks
    git.rs              # Git CLI wrappers (branches, worktrees)
    pty.rs              # PTY session management
    settings.rs         # Claude Code settings CRUD
    paths.rs            # Path helpers and atomic file writes

License

This project is licensed under the GNU Affero General Public License v3.0.