Skip to main content
This guide walks you through setting up your first project and running multiple AI agents in parallel.

​
Prerequisites

Before you start, make sure you have:
  • Termpad installed on your machine
  • A git repository you want to work with
  • At least one AI coding tool (Claude Code, Gemini CLI, etc.)

​
Step 1: Add a Project

1

Open Termpad

Launch Termpad from your applications menu or desktop.
2

Click Add Repository

In the sidebar, click Add Repository.
3

Select your repository

Navigate to your git repository folder and select it, or go to the Clone tab to clone directly from a GitHub URL.
Your project now appears in the sidebar with your main branch shown.

​
Step 2: Create Your First Worktree

A worktree is an isolated workspace with its own git worktree and terminals. Each worktree runs independently, so changes in one worktree don’t affect others.
1

Click Add Worktree

With your project selected, click the Add Worktree button.
2

Name your branch

Enter a name for the new branch (e.g., feature/login-page).
3

Wait for setup

Termpad creates a new git worktree and opens a terminal worktree. If you’ve configured setup scripts, they run automatically.

​
Step 3: Launch an AI Agent

Your worktree is ready. Now launch your AI coding tool in the terminal.
Give Claude a task and let it work while you create another worktree.

​
Step 4: Create More Worktrees

While your first AI is working, create additional worktrees for parallel work.
1

Create another worktree

Click Add Worktree again and give it a different branch name (e.g., feature/user-profile).
2

Launch another AI agent

In the new terminal, start another AI tool with a different task.
3

Repeat as needed

Create as many worktrees as your machine can handle. Each runs in complete isolation.
Each worktree gets its own git worktree, so there’s no risk of merge conflicts between worktrees while you work.

​
Step 5: Review and Merge

When an AI finishes its task, review the changes before merging.
1

Open the diff viewer

Click on a worktree to see what files changed. The diff viewer is located in the top right corner of the source control header.Use the diff viewer to review the code and add comments on specific lines. Once you’ve annotated all the issues, click the copy button at the top to copy all comments automatically, then paste them into your AI agent CLI to generate fixes.
2

Stage and commit

Use the source control panel to stage changes and create commits.
3

Create a PR

Click the Create PR icon in the source control footer to open a pull request on GitHub.
4

Clean up

Once merged, delete the worktree to remove the worktree and free up disk space.

​
What’s Next?

Worktrees

Learn more about running multiple agents

Configure Scripts

Set up automatic setup and cleanup scripts

Manage Terminals

Master terminal tabs and presets

Review Changes

Review and commit AI-generated code