wt

Manages git worktree isolation with dedicated Postgres databases, Redis containers, and ports.

2|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/Tokenbooks/wt --skill wt-tokenbooks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wt
Source: https://github.com/Tokenbooks/wt/tree/main/skills/wt
Command: npx skills add https://github.com/Tokenbooks/wt --skill wt-tokenbooks

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill solves the problem of parallel development worktrees corrupting each other's data by providing isolated environments for databases, Redis, and ports.

Core Features & Use Cases

  • Worktree Isolation: Assigns each worktree a unique "slot" to manage its resources.
  • Resource Management: Automatically configures isolated Postgres databases, Redis containers, and port ranges per worktree.
  • Use Case: When working on multiple features simultaneously, wt ensures that schema migrations in one branch do not affect another, and development servers can run on distinct ports without conflict.

Quick Start

Initialize the wt CLI in your repository by running the init command.

Frequently Asked Questions about wt

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

FAQPage Schema
How do I prevent git worktrees from corrupting parallel development databases?

Git worktree isolation prevents parallel development corruption by assigning each worktree a unique slot with dedicated Postgres databases, Redis containers, and port assignments to keep branch resources independent.

Can I run isolated Redis containers and Postgres databases for each git branch?

Yes, you can run isolated Redis containers and Postgres databases per git branch by initializing the wt CLI in your repository, which automatically configures distinct resource slots for each worktree.

How do I manage port assignments for multiple development servers in git worktrees?

Manage port assignments for multiple development servers by utilizing worktree isolation, which automatically assigns unique port ranges to each worktree to prevent development server conflicts across branches.

What is the best way to isolate database schemas when working on multiple features simultaneously?

The best way to isolate database schemas across simultaneous features is using worktree isolation, which ensures schema migrations in one branch do not affect another by providing dedicated Postgres databases.

How do I list, remove, and prune inactive git worktrees and their isolated resources?

List, remove, and prune inactive git worktrees and their isolated resources using the dedicated diagnostics commands provided by the wt CLI, which cleans up orphaned databases, Redis containers, and port assignments.