BradenTerry

agent-worktrees: Manage Claude Agents Across Git Worktrees

A VS Code extension for starting and monitoring Claude Code agents in isolated Git worktrees. It brings agent status, worktree Git state, and optional GitHub pull request checks into one panel.

Stars
1
Forks
0
Stars, last 14 days
+0
Last commit
23 days ago
Contributors
2

Our take

Newless than six months old and changing fast

Health score

49/100

How it is scored
Activity
79
Community
18
Issues
21
Pull requests
77

+0 stars in the last 14 days

  • Releases more often than 90% of the projects we track
  • Merges more pull requests than 83% of the projects we track
  • Fewer contributors than 86% of the projects we track

This is a feature-rich VS Code workflow tool for Claude Code users, but its recent, fast-moving development and concentrated contributor base make it worth evaluating before relying on it for team-critical work.

Good fit if

  • You already use Claude Code and Git worktrees, and want a single VS Code view for parallel sessions.
  • Optional PR checks, waiting-agent alerts, and worktree-specific controls fit your workflow.
  • You are comfortable with a young project that has been changing rapidly, with most contributions coming from one person.

Look elsewhere if

  • You need a tool that works independently of VS Code, Claude Code, or Git worktrees.
  • You need reliable terminal reveal after an extension-host reload; terminal handles are tracked in memory and can be lost.
  • Your setup cannot meet the Node.js extension environment and Git and Claude CLI requirements.
All health signals
Last commit2026-09-14 (23 days ago)
Commits, last 90 days93
Releases, last 12 months73 (latest v4.6.12, 2026-09-14)
Contributors2 (top contributor: 91% of commits)
Issues closed, last 90 days0
Pull requests merged, last 90 days72 (typically merged in 0 days)
Project age4 months

Checked on 2026-10-07 with the GitHub API.

Overview

Agent Worktrees is a VS Code side panel for coordinating Claude Code sessions across a repository’s Git worktrees. Each worktree provides an isolated checkout, while the panel gives developers one place to see which agents are active, waiting, or idle and to manage their worktrees.

It is aimed at people who run several Claude Code tasks in parallel and want to avoid juggling separate terminals and Git commands. GitHub pull request status is optional; the extension can also be useful for worktree and agent management without that integration.

Key Features

  • Start Claude Code sessions in existing worktrees, or create a worktree and start an agent in one step.
  • View agent status across worktrees, including waiting-agent notifications and an all-agents view.
  • See Git status and, when configured, pull request reviews and CI checks alongside each worktree.
  • Create, switch, search, open, and remove worktrees from the panel.
  • Group worktrees and pin agents to make frequently used items easier to find.
  • Inspect Claude subagents and the skills used by an agent.
  • Link gitignored local files into worktrees, with Windows-specific link fallbacks.
  • Open worktree-specific launch configurations in VS Code’s debugger.

Use Cases

  • A developer handling several independent coding tasks can give each Claude Code agent its own worktree and monitor which sessions need input.
  • A team reviewing agent-generated branches can check Git state and optional pull request checks without switching between the panel and terminal for every worktree.
  • A developer who keeps several branches checked out can group and search worktrees, then start or stop Claude sessions from the same view.
  • Someone testing changes in an agent’s worktree can launch its configured debugger without changing the current workspace folder.

What you need

Detected in the repository

  • Node.js (from package.json)
  • A test suite and automated checks on GitHub Actions

License in plain words

MITpermissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the copyright and license notice
  • Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Install the Agent Worktrees extension from the VS Code Marketplace. It requires git and the Claude Code CLI on your PATH, and a workspace whose first folder is inside a Git repository. See the README for setup and feature details.

Alternatives

  • oh-my-claudecode: oh-my-claudecode orchestrates parallel Claude Code agents, while agent-worktrees focuses on launching and monitoring agents in separate Git worktrees.
ProjectLanguageLicenseStarsStatus
agent-worktreesTypeScriptMIT1New
oh-my-claudecodeTypeScriptMIT39.6kActive

Considerations

The repository is marked new and has seen frequent commits and releases, so its interface and behavior may continue to evolve. Recent development is concentrated: two contributors are recorded, with most contributions from one person. The measured data reports no issues closed in the past 90 days, though the repository currently has no open issues.

This is a VS Code extension, not a standalone agent runner. It depends on Git and the Claude Code CLI, locates the repository from the first workspace folder, and cannot reveal a terminal it does not own or one whose handle was lost after an extension-host reload. Agent status is read from Claude Code’s local session files; the README says the extension does not send this data over the network. The project uses the MIT license.

Found this useful?

Share it with someone who would like agent-worktrees.

Comparisons