Skip to content
forktty_
Download
Worktrees

Git worktrees as first-class agent workspaces.

ForkTTY treats git worktrees as visible workspaces so parallel agents can work on separate branches without overwriting each other's checkout. Create, attach, merge, and remove worktrees from the terminal UI or local automation surface.

Download for LinuxSource repository

Quick start

Point commands at a repo that is already represented by a ForkTTY workspace or surface cwd; hidden repos are rejected by design.

List existing worktrees
forktty worktree-list --cwd /path/to/repo
Create an isolated branch workspace
forktty worktree-create feature/my-task --cwd /path/to/repo
Check current worktree state
forktty worktree-status --cwd /path/to/repo
Attach an existing branch workspace
forktty worktree-attach feature/my-task --cwd /path/to/repo

Parallel work without checkout collisions

Each agent lane can get its own directory, branch, pane tree, and task state. A leader can keep mutating workers separated while read-only review workers share context when appropriate.

Visible repository boundary

Worktree socket, CLI, and MCP operations require an explicit repo path and validate it against repositories already represented by visible ForkTTY workspace or surface cwd. Hook-reported resume cwd is context, not authorization.

Safer cleanup

Worktree remove and merge flows check dirty state and linked worktree metadata before changing repository state. ForkTTY reports preconditions instead of silently operating on unopened repositories.

Questions

Why use git worktrees with AI agents?
They let multiple agents edit different branches at the same time without sharing one mutable checkout.
Can ForkTTY create worktrees from the UI?
Yes. ForkTTY exposes worktree create, attach, merge, and remove flows through the GTK app and local automation API.
Can a socket client mutate any repo on disk?
No. Worktree operations are bounded to repositories visibly represented in ForkTTY.

Explore related ForkTTY pages

CodexTeam orchestrationMCPDocs

Get the alpha build

AppImage and .deb packages are published on GitHub Releases for Linux x86_64.

View releases