tmux-worktree-session

Community

Manage tmux sessions with git worktrees

Authormshuffett
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill streamlines the process of creating or switching to a Git worktree within a tmux session, ensuring session continuity and seamless integration with AI coding assistants like Codex and Claude.

Core Features & Use Cases

  • Worktree Creation & Session Management: Create new Git worktrees from an active session without losing your current context.
  • Seamless Pane Splitting: Automatically splits your tmux pane to accommodate the new worktree, allowing you to continue your work in the new environment.
  • AI Assistant Integration: Supports resuming or forking Codex and Claude sessions, automatically detecting the current session and launching the appropriate state in the new pane.
  • Use Case: You're working on a feature branch and need to start a new task on a different branch. Use this skill to quickly create a worktree for the new task, split your tmux pane, and have your AI assistant ready in the new pane, preserving your previous session's context.

Quick Start

Use the global command wts followed by the name of your new worktree to create and switch to it, resuming your current AI session in a new tmux pane.

Dependency Matrix

Required Modules

None required

Components

scriptsreferences

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: tmux-worktree-session
Download link: https://github.com/mshuffett/dotfiles/archive/main.zip#tmux-worktree-session

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.