Overview

Learn the core concepts of projects, tasks, and sessions, and how parallel git worktrees let you run multiple AI coding agents simultaneously.

Verun is the open-source desktop workspace for parallel AI coding agents. Spin up multiple agents — each in its own isolated git worktree — and manage them all from a single native app with a full code editor, terminal, diff viewer, and git workflow built in.

Key Concepts

Project — A git repository added to Verun. Has a name, path, and optional .verun.json configuration for hooks and start commands.
Task — A unit of work that owns a dedicated git worktree and an auto-generated branch (e.g. fizzbuzz-dragon-472). Each task gets 10 unique ports and runs its own dev server independently.
Session — A resumable AI agent conversation within a task. Each session has its own agent type, model, and conversation history. Multiple sessions can run within the same task and worktree.

How it Works

Project (git repo)
  └── Task (worktree + branch + ports)
        └── Session (agent conversation)

Add a repo, create tasks — each gets an isolated worktree forked from your base branch. Set up hooks to copy .env files and install dependencies automatically. Start agent sessions per task; agents read and write files only inside their own worktree. Review diffs, commit, push, and open PRs without leaving the app.

UI Layout

┌─ Sidebar ──────┬─ [+ Claude Code ×] [File.tsx ×] ── Main Area ──┬─ Right Panel ─┐
│ Projects       │                                                  │ Files         │
│   └─ Tasks     │  Chat / Code Editor                             │ Search        │
│                │                                                  │ Source Control│
├────────────────┴──────────────────────────────────────────────────┴───────────────┤
│ Terminal (xterm.js, collapsible)                                                   │
└────────────────────────────────────────────────────────────────────────────────────┘

Sidebar — projects and tasks; click a task to open it
Tab bar — sessions and open files share one tab bar across the top of the main area; click + to start a new session and pick an agent
Main area — agent chat view when a session tab is active, CodeMirror editor when a file tab is active
Right panel — file tree, workspace search (ripgrep), and source control diffs
Terminal — per-task PTY shell; also shows setup hook and dev server output

Why Verun?

Parallel by default — run dozens of agents at once, each safely isolated in its own worktree
Full workspace — editor, terminal, search, diffs, and git workflow all in one window
Stay in control — three trust levels, fork from any message, per-turn snapshots, desktop notifications
Local & private — no account, no subscription, no telemetry, no data leaving your machine

Tech Stack

Verun is built with Tauri v2 (Rust + Tokio), SolidJS + TypeScript, CodeMirror 6, xterm.js, and SQLite. The app runs entirely on your machine — no server, no cloud sync.