# agent-worktrees: Manage Claude Agents Across Git Worktrees

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/bradenterry-agent-worktrees
Generated for open source discovery and AI-assisted research.

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.

GitHub: https://github.com/BradenTerry/agent-worktrees
OSRepos URL: https://osrepos.com/repo/bradenterry-agent-worktrees

## Summary

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.

## Topics

- typescript
- developer-tools
- ai-agents
- claude-code
- vscode-extension
- git-worktrees
- claude-code-agents

## Repository Information

Last analyzed by OSRepos: Wed Oct 07 2026 08:14:25 GMT+0100 (Western European Summer Time)
Detail views: 5
GitHub clicks: 8

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## 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.

## Our Take

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.

## Project Health

| Signal | Value |
|---|---|
| Status | **New**: less than six months old and changing fast |
| Last commit | 2026-09-14 (23 days ago) |
| Commits, last 90 days | 93 |
| Releases, last 12 months | 73 (latest v4.6.12, 2026-09-14) |
| Contributors | 2 (top contributor: 91% of commits) |
| Issues closed, last 90 days | 0 |
| Pull requests merged, last 90 days | 72 (typically merged in 0 days) |
| Project age | 4 months |

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

## Project Facts

- Language: TypeScript
- License: MIT
- Stars: 1
- Forks: 0
- Topics: agentic-ai, ai-agents, anthropic, claude, claude-code, developer-tools, git-worktree, github
- Archived: no

## What You Need

Detected in the repository:

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

## Getting Started

Install the [Agent Worktrees extension from the VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=bradenterry.agent-worktrees). 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](https://github.com/BradenTerry/agent-worktrees#readme) for setup and feature details.

## License in Plain Words

**MIT** (permissive).

- 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.

## Alternatives

- [oh-my-claudecode](https://osrepos.com/repo/yeachan-heo-oh-my-claudecode): oh-my-claudecode orchestrates parallel Claude Code agents, while agent-worktrees focuses on launching and monitoring agents in separate Git worktrees.

| Project | Language | License | Stars | Status |
|---|---|---|---|---|
| **agent-worktrees** | TypeScript | MIT | 1 | New |
| [oh-my-claudecode](https://osrepos.com/repo/yeachan-heo-oh-my-claudecode) | TypeScript | MIT | 39.6k | Active |

## 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.