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 workspace for parallel coding agents. Spin up multiple AI coding agents — each in its own isolated git worktree — and manage them from a single native app with a full editor, terminal, and git workflow built in.
Key Concepts
- Project — A git repository added to Verun. Has a name, path, and
.verun.jsonconfiguration. Can contain multiple tasks. - Task — A unit of work that owns a worktree and an auto-generated branch name (e.g.,
sleepy-capybara-472). Independently deployable and reviewable. - Session — A resumable AI agent conversation within a task. Has a selected agent provider, trust level, and conversation history. Multiple sessions can exist per task.
How it Works
Project (repo) → Tasks (worktrees) → Sessions (agent conversations)Add a repo, create tasks — each gets an isolated worktree with an auto-generated branch name. Run multiple agent sessions per task and switch between them freely. Lifecycle hooks copy .env files, install dependencies, and start dev servers automatically.
Why Verun?
- Parallel by default — Run dozens of agents at once, each in its own worktree.
- Full workspace — Code editor, terminal, diffs, and git workflow built in.
- Stay in control — Tool approval levels, fork from any message, desktop notifications.
- Local & private — No account, no subscription, no data leaving your machine.
Tech Stack
Verun is built with Tauri v2 (Rust + tokio), Solid.js + TypeScript, UnoCSS, xterm.js, and SQLite. The app runs entirely on your machine with no server component.