project-session-manager

Create Git worktrees and tmux sessions for isolated development environments.

Updated Mar 17, 2026
One-click install
npx skills add https://github.com/Rheinmir/skills-kit --skill project-session-manager-rheinmir
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-session-manager
Source: https://github.com/Rheinmir/skills-kit/tree/main/skills/project-session-manager
Command: npx skills add https://github.com/Rheinmir/skills-kit --skill project-session-manager-rheinmir

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automate the creation and management of isolated development environments by combining Git worktrees with tmux sessions, enabling parallel work across issues, features, and PRs without conflicts.

Core Features & Use Cases

  • Create per-project worktrees linked to tmux sessions for lightweight, parallel development.
  • Maintain a local sessions registry and per-worktree metadata for quick discovery and switching.
  • Support for project aliases, easy cleanup, and optional integration with common CLI tools.

Quick Start

Create a new worktree for a given project and start a tmux session to begin work.

Frequently Asked Questions about project-session-manager

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

FAQPage Schema
How do I manage isolated Git worktrees with tmux for parallel development?

You can manage isolated Git worktrees with tmux by automating the creation of linked worktree directories and tmux sessions, allowing parallel work across issues and features without conflicts. A local registry tracks these sessions for quick discovery and switching.

What is the best way to handle multiple development environments for concurrent PR reviews?

Handling multiple development environments for concurrent PR reviews is best done by creating per-project Git worktrees linked to separate tmux sessions. This isolates dependencies and branches, while per-worktree metadata enables quick switching between active reviews.

Do I need Git and tmux installed to automate dev environments with a worktree registry?

Yes, you need Git with worktree support and tmux installed to automate dev environments. Optional CLI tools for providers can enhance integration, but the core workflow relies on Git and tmux to create isolated sessions and maintain the local registry at ~/.psm.

Can I use project aliases to switch between Git worktrees and tmux sessions quickly?

Yes, you can use project aliases to switch between Git worktrees and tmux sessions quickly. The system maintains a local sessions registry and per-worktree metadata, enabling rapid discovery and navigation across your parallel development tasks.

How does a worktree registry help with cleaning up parallel task environments?

A worktree registry helps with cleanup by maintaining per-worktree metadata at ~/.psm, allowing easy identification and removal of isolated Git worktrees and their associated tmux sessions once a parallel task, issue fix, or PR is complete.

Why use Git worktrees instead of cloning multiple repos for parallel feature development?

Using Git worktrees instead of cloning multiple repos for parallel feature development shares a single object database, saving disk space. Linking these worktrees to tmux sessions provides lightweight, isolated environments that prevent branch conflicts.