הפוסט הזה כתוב באנגלית.

Many agents, one project: worktree tabs

Run several agents in parallel git worktrees and switch between them like tabs. Each tab re-points the Project tree, Local Changes, terminals and chat, and agents are told what the others are editing.

Ethan Caldwell2 דקות קריאה

Worktree tabs under the title bar, main, ingot/login and ingot/cart, with uncommitted file counts and a shared-file warning in the chat

One agent at a time is a waste of a fast machine. Ingot can run agents side by side, each in its own git worktree on its own branch, so they never step on each other's uncommitted files. Worktree tabs make those parallel checkouts feel like tabs.

One tab per worktree

Turn them on in Settings › Version Control › Worktrees (Tabs under the title bar), or with the Worktree tabs switch in Settings › Features. A slim strip appears under the title bar. The first tab is your project with its real branch; after it comes one tab per worktree thread. Each tab shows:

  • a state dot: running, waiting for you, done, error or idle
  • the thread's branch, such as ingot/login
  • how many files are uncommitted in that worktree
  • ⚠ n when files this thread edited were also edited in another worktree

Worktrees come from threads in a git worktree, Arena and task subagents.

Click a tab, and everything follows

Clicking a tab points the IDE at that checkout. The Project tree shows the worktree folder, Local Changes shows its changes and commits go there, new terminals start in it, and the Agents panel shows that thread's chat. The project tab points everything back. Your workspace itself does not change.

Reload the window or restart Ingot and you land on the tab you left. In the side bar header, the active worktree's branch sits next to the project name; click it to switch to another worktree.

When a thread is done, Finish on the tab merges, applies or discards the worktree.

Agents that know about each other

Parallel agents have one classic failure: two of them quietly edit the same file. Ingot's team awareness is on by default:

  • Team block. Every run of an agent in a worktree gets a short block in its instructions listing the other threads, their branches and status, the files they touched and the files more than one thread edited. The agent is asked to avoid those, or to say so when it must touch one.
  • /team. Type /team in the chat to print the same block.
  • Shared-file warning. When two threads edit the same path, both chats get one line, for example src/shared.ts is also being edited in thread 'Cart totals' (ingot/cart).

The chat after /team: the Team block listing ingot/login and ingot/cart with the files each edited, and src/shared.ts under Files edited in more than one worktree

Keys

Cycle tabs with ⌃⌥] and ⌃⌥[ on macOS, or Ctrl+Alt+Shift+PageDown and PageUp on Windows and Linux. Switch to Worktree… in Find Action lists them all.

Everything else is in Worktree tabs. Worktree tabs work the same in the desktop app and the browser.