Usage

Learn how to configure and use Verun for parallel AI agent development.

Adding a Project

Open Verun and click Add Project. Select any git repository on your machine. Verun will index the repo and prepare it for worktree-based task isolation.

Configuration

Create a .verun.json file in your project root to define lifecycle hooks. These run automatically when a new task is created.

{
  "setup": [
    "cp .env.example .env",
    "pnpm install",
    "pnpm run dev"
  ],
  "ports": [3000, 5173],
  "env": {
    "NODE_ENV": "development"
  }
}

Creating Tasks

Each task automatically creates an isolated git worktree with a unique branch name. The setup commands from your .verun.json run automatically so each agent starts ready to work.

Task: "Refactor auth module"
  ├── Branch: sleepy-capybara-472
  ├── Worktree: .verun/worktrees/sleepy-capybara-472/
  ├── Ports: 3001
  └── Status: Running

Task: "Add dark mode"
  ├── Branch: brave-penguin-891
  ├── Worktree: .verun/worktrees/brave-penguin-891/
  ├── Ports: 3002
  └── Status: Generating

Agent Sessions

You can run multiple sessions per task. Sessions are resumable — close your laptop and pick up exactly where you left off. Each session talks directly to the CLI agent (e.g., Claude Code).

Reviewing Changes

View side-by-side diffs for working-tree changes and individual commits. Syntax-highlighted diffs make it easy to review what agents changed. Click any line to navigate to the file in the built-in editor.

Git Workflow

Commit, push, create PRs, and merge — all without leaving the app. Verun integrates with your existing git hosting (GitHub, GitLab, etc.) through the CLI.