recollect-worktree

Create and manage isolated Git worktrees with environment setup and dependency installation.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/timelessco/recollect --skill recollect-worktree
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: recollect-worktree
Source: https://github.com/timelessco/recollect/tree/main/.claude/skills/recollect-worktree
Command: npx skills add https://github.com/timelessco/recollect --skill recollect-worktree

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, pnpm, and includes scripts (resource) components.

What problem does it solve?

This Skill manages Git worktrees for Recollect development, enabling isolated PR reviews and parallel feature work by creating dedicated worktrees in .worktrees/, copying .env.local, and automatically installing dependencies.

Core Features & Use Cases

  • Worktree Creation: Create a new worktree from main with a clear branch-based name.
  • Environment Sync: Copy .env.local into each worktree to keep credentials in sync.
  • Automation: Run pnpm install to ensure dev-ready environments.
  • Worktree Management: List, switch between, and clean up inactive worktrees.
  • Use Case: Review a PR in isolation without touching the main working tree.

Quick Start

  • Create a new worktree: bash .claude/skills/recollect-worktree/scripts/worktree-manager.sh create feature-login
  • List all worktrees: bash .claude/skills/recollect-worktree/scripts/worktree-manager.sh list
  • Switch to a worktree: bash .claude/skills/recollect-worktree/scripts/worktree-manager.sh switch feature-name
  • Cleanup inactive worktrees: bash .claude/skills/recollect-worktree/scripts/worktree-manager.sh cleanup

Frequently Asked Questions about recollect-worktree

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create isolated Git worktrees for parallel development?

Git worktrees enable parallel development by creating separate working directories linked to your repository. This Skill automates worktree creation from main, copies your .env.local file, and runs pnpm install to set up isolated environments for PR reviews or feature branches without affecting your main working tree.

Can I use Git worktrees with pnpm to review PRs in isolation?

Yes. This Skill creates worktrees, syncs environment variables, and installs dependencies with pnpm automatically. You can review a PR in a dedicated worktree without touching main, then switch back or clean up when done.

What's the best way to manage multiple Git worktrees?

This Skill provides commands to list all active worktrees, switch between them, and clean up inactive ones. Worktrees are stored under .worktrees/ with safety checks, making it easy to track and organize parallel workstreams.

How do I set up a new worktree with environment variables and dependencies?

Run the create command with a branch name; the Skill automatically creates a worktree from main with -b branch creation, copies .env.local, and executes pnpm install so your environment is dev-ready immediately.

Do I need to manually copy .env.local into each worktree?

No. This Skill copies .env.local automatically when you create a worktree, keeping credentials and configuration in sync across isolated development environments without manual setup.