Agntree — Claude Code Session & Worktree Manager for VS Code & Cursor

The missing session manager for Claude Code. Resume, fork, search, and organize your Claude Code CLI sessions across git worktrees — all from a single VS Code sidebar. Works with VS Code & Cursor. Extensible architecture — contributions for Copilot, Cline, Aider, and more are welcome.

Table of Contents

• Why Agntree?
• Features
• Demo
• Quick Start
• Installation
• Agntree vs Manual Workflow
• Supported AI Coding Agents
• Usage Guide
• Settings
• Commands
• Architecture
• FAQ
• Roadmap
• Contributing
• License

Why Agntree?

If you use Claude Code CLI across multiple projects and branches, you know the pain:

• Lost sessions — finding and resuming Claude Code sessions means digging through ~/.claude/projects/ or remembering session IDs
• No session overview — there's no way to see all your Claude Code conversations across repos and branches at a glance
• Manual worktree juggling — running parallel Claude Code sessions on different branches requires manually creating worktrees and terminals
• No session forking — exploring an alternative approach means manually copying Claude session files and setting up a new worktree
• Blind changes — tracking what Claude Code modified requires constant git diff commands

Agntree gives Claude Code a visual session manager inside VS Code — resume any session with one click, fork conversations to explore alternatives, and see all changes across worktrees in a single sidebar.

Features

Claude Code Session Management

Create, resume, rename, and organize your Claude Code sessions. Every session links to a Claude Code session ID for seamless --resume support. Import existing sessions from ~/.claude/projects/ with multi-select. Search all Claude Code sessions across a repository's worktrees with the repository-level Search Sessions command.

Git Worktree Integration

Automatically detects git worktrees for each repository. Create new worktrees with one click — choose an existing branch or create a new one from any base branch. Worktrees are organized in a dedicated <repo>-worktrees/ folder.

Session Forking — Branch Your Claude Code Conversations

Fork an ongoing Claude Code session to explore alternative approaches — just like branching your code. Fork within the same worktree or create a new worktree with all uncommitted changes carried over. The full conversation history is preserved so Claude can resume from the forked point.

PR Checkout

Check out any GitHub pull request into a new worktree with one click. Works for PRs from both same-repo branches and forks — the gh CLI handles remote resolution automatically. Available from the repository's inline actions or context menu.

One-Click Quick Actions

Run Claude prompts or shell commands with a single click from the sidebar. Configure custom actions in settings — use Claude's headless mode with specific tools, or run any shell command. Play/stop controls with output displayed in a dedicated channel.

Built-in Changes Tracking

View staged and unstaged changes for the active worktree without leaving the sidebar. Inline stage, unstage, and discard actions. Click any file to open a side-by-side diff. Section headers show file count and total additions/deletions.

All Files Panel

Browse, create, rename, delete, copy, cut, and paste files and folders for the active worktree — all from the sidebar. Click the search icon in the panel toolbar to open VS Code's native Search scoped to that worktree's directory.

Demo

Quick Start

1. Install Claude Code CLI if you haven't already
2. Install Agntree from the VS Code Marketplace
3. Click the Agntree icon in the Activity Bar, add a repository, and start managing your Claude Code sessions

Installation

From VS Code Marketplace

Install directly from the VS Code Marketplace — search for "Agntree" in the Extensions panel, or click the link.

Works on both VS Code and Cursor (Cursor is a VS Code fork and supports VS Code extensions).

From VSIX

1. Download or build the .vsix file
2. In VS Code, open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P)
3. Run Extensions: Install from VSIX...
4. Select the agntree-x.x.x.vsix file

From Source

git clone https://github.com/subhashkhileri/agntree.git
cd agntree
npm install
npm run compile
npx @vscode/vsce package
code --install-extension agntree-*.vsix

Requirements

• VS Code 1.85.0+ or Cursor
• Claude Code CLI installed and configured
• Git installed and available in PATH
• GitHub CLI (gh) for PR checkout feature (optional)

Agntree vs Manual Claude Code Workflow

Supported AI Coding Agents

Agntree is built for Claude Code — Anthropic's CLI coding agent. Full session management is supported: resume, fork, search, import, and organize Claude Code sessions. The architecture is open-source and extensible — contributions to add support for other AI coding agents are welcome.

See CONTRIBUTING.md for a guide on adding support for new agents.

Usage Guide

Getting Started

1. Click the Agntree icon in the Activity Bar (left sidebar)
2. Click Add Local Repository or Clone from GitHub to add your first repository
3. The extension automatically detects worktrees in the repository

Managing Repositories

Clone from GitHub: Enter a GitHub URL (https://github.com/owner/repo) or shorthand (owner/repo), select a parent folder, and the repository will be cloned and added automatically.

Working with Worktrees

Create Worktree Flow:

1. Choose "Existing branch" or "New branch"
2. For new branches: select the base branch to branch from, then enter the new branch name
3. Confirm the worktree path (defaults to <repo>-worktrees/<branch-name>)

Worktrees are organized in a dedicated folder (e.g., my-repo-worktrees/) for cleaner organization.

Managing Sessions

Note: Removing a session only removes it from the extension's list. The Claude session files in ~/.claude/ are preserved and can be re-imported later.

Fork Session to New Worktree: Creates a new git worktree, copies uncommitted changes from the current worktree, copies the Claude session data, and opens a forked session in the new worktree. Useful for exploring alternative approaches while preserving your current work.

Viewing Changes

The Changes panel shows uncommitted changes for the currently selected worktree:

• Staged Changes section shows files ready to commit
• Changes section shows unstaged modifications
• Click on any file to open a diff view (toggle on/off)
• Inline actions: Stage (+), Unstage (-), Discard changes
• Section headers show file count and total additions/deletions
• Changes are auto-refreshed when files are modified
• Panel title shows active worktree and repository name

Quick Actions

The Quick Actions panel lets you run commands with one click:

• Claude mode: Run Claude headlessly with a prompt and allowed tools
• Command mode: Run any shell command directly (cross-platform)
• Play/Stop buttons to start and terminate running actions
• Output displayed in "Agntree Quick Actions" output channel
• Panel title shows active worktree and repository name

Default quick actions:

• Commit — Runs Claude with a commit prompt
• Git Status — Runs git status command

Configuration (Settings → agntree.quickActions):

{
  "agntree.quickActions": [
    {
      "name": "Commit",
      "icon": "git-commit",
      "prompt": "Run the /commit-commands:commit slash command",
      "allowedTools": "Bash(git:*),Read,Glob,Grep"
    },
    {
      "name": "Build",
      "icon": "tools",
      "command": "npm run build"
    }
  ]
}

Settings

Toggle autoSwitchWorkspaceFolder and focusOnStartup directly from the Workspaces panel toolbar — no need to open Settings.

Commands

All commands are available in the Command Palette (Cmd+Shift+P / Ctrl+Shift+P):

Architecture

src/
├── extension.ts              # Extension entry point
├── types.ts                  # TypeScript interfaces and types
├── commands/
│   ├── repository.ts         # Repository management commands
│   ├── worktree.ts           # Worktree commands
│   ├── chat.ts               # Session commands
│   └── quickActions.ts       # Quick action commands
├── providers/
│   ├── WorkspacesTreeProvider.ts   # Main sidebar tree view
│   ├── ChangesTreeProvider.ts      # Changes panel tree view
│   └── QuickActionsTreeProvider.ts # Quick actions panel tree view
└── services/
    ├── StorageService.ts     # Persistent storage (globalState)
    ├── GitService.ts         # Git operations (worktrees, diffs)
    ├── TerminalManager.ts    # VS Code terminal management
    ├── ClaudeSessionService.ts    # Claude session discovery & parsing
    └── SessionWatcher.ts     # Watches for new sessions, auto-naming

Data Flow

1. Repository Added → Stored in VS Code's globalState
2. Worktrees Detected → GitService runs git worktree list --porcelain
3. Session Created → TerminalManager spawns terminal with claude CLI
4. Session Linked → Session links to Claude Code's session ID for --resume

Extensibility

The architecture separates agent-specific logic (currently in ClaudeSessionService) from the core session management. Adding support for a new AI coding agent involves implementing a new session service that conforms to the same interface. See CONTRIBUTING.md for details.

FAQ

What is Agntree?

Agntree is a free, open-source VS Code extension that serves as a session manager for Claude Code CLI. It provides a visual sidebar to create, resume, fork, search, and organize your Claude Code sessions across git repositories and worktrees — replacing the need to manually track session IDs or browse ~/.claude/projects/.

Does Agntree work with Cursor?

Yes. Cursor is a fork of VS Code and supports VS Code extensions. Agntree works on both VS Code and Cursor without any modification.

Can I use Agntree with Copilot, Cline, or Aider?

Agntree currently provides full session management for Claude Code. The architecture is extensible and open-source — contributions to add support for GitHub Copilot, Cline, Aider, Windsurf, Continue.dev, and other AI coding agents are welcome. See the Contributing section.

What are git worktrees and why use them with Claude Code?

Git worktrees let you check out multiple branches of the same repository into separate directories simultaneously. This is powerful with Claude Code because you can run separate Claude Code sessions on separate branches in parallel, without conflicts. Agntree makes creating worktrees and launching Claude Code sessions on them effortless.

How is session forking different from starting a new Claude Code session?

When you fork a Claude Code session, the full conversation history is copied to the new session. Claude retains all context from the original conversation and can continue from that point. Starting a new session means Claude has no memory of previous work. Forking is ideal for exploring alternative approaches while keeping the original Claude Code session intact.

Is Agntree free?

Yes. Agntree is free and open-source under the MIT license. You need your own Claude Code subscription (Claude Pro, Max, or Team) to use the session management features.

Roadmap

Agntree's roadmap is community-driven. Key areas of interest:

• Multi-agent support — Extensible architecture for Copilot, Cline, Aider, Windsurf, and other AI coding agents (contributions welcome)
• Custom workflow templates — Sharable quick action configurations for teams
• Team collaboration features — Shared session management across team members
• Session analytics — Track AI-assisted development metrics across projects

Have ideas? Open an issue or start a discussion.

Contributing

Contributions are welcome! See CONTRIBUTING.md for detailed guidelines, including a section on adding support for new AI coding agents.

Quick start:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run npm run lint to check for issues
5. Submit a pull request

Star History

License

MIT — free for personal and commercial use.

Built for use with Claude Code by Anthropic. Agntree is an independent open-source project and is not affiliated with or endorsed by Anthropic.