skills.rest
OliverOuyang
OliverOuyangCOMMUNITY
Explore all skills by this author →
GitHub

project-session-manager

Manage isolated git worktrees and tmux sessions for development tasks.

1|Updated Apr 1, 2026
Search Tags:#automation#github#worktree#tmux#jira#code-review#session-manager
One-click install
npx skills add https://github.com/OliverOuyang/shuhe-work-skills --skill project-session-manager-oliverouyang
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: project-session-manager
Source: https://github.com/OliverOuyang/shuhe-work-skills/tree/main/skills/project-session-manager
Command: npx skills add https://github.com/OliverOuyang/shuhe-work-skills --skill project-session-manager-oliverouyang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing concurrent development tasks (PR reviews, issue fixes, feature work) across repositories is error-prone when using a single working copy, leading to branch conflicts, context switching overhead, and lost local state. Project Session Manager automates creation of isolated git worktrees, optional tmux sessions, and a local session registry so each task has its own reproducible environment and lifecycle.

Core Features & Use Cases

  • Worktree-first workflow: create isolated worktrees for PRs, issues, and feature branches without contaminating the main workspace.
  • Session orchestration: optionally create tmux sessions, launch Claude Code, and maintain a sessions.json registry for attach/kill/cleanup operations.
  • Provider integration: resolve references and fetch metadata using GitHub and Jira CLIs, clone repos if missing, and provide automated cleanup of merged/closed worktrees.
  • Use Case: run a PR review that clones the repo if necessary, creates a dedicated worktree and tmux session, opens Claude Code for contextual assistance, and later automatically cleans the session when the PR is merged.

Quick Start

Run psm review omc#123 to create a PR review worktree, tmux session, and launch Claude Code.

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 for concurrent PR reviews and feature branches?▼

Isolated git worktrees for concurrent PR reviews and feature branches are managed by automatically creating dedicated working directories and optional tmux sessions. This prevents branch conflicts and local state contamination across multiple development tasks.

Can I launch tmux sessions and Claude Code automatically when creating a worktree?▼

Yes, tmux sessions and Claude Code can be optionally launched during worktree creation. The session orchestration maintains a local registry for attach, kill, and cleanup operations across the isolated development environments.

Does git worktree automation work with GitHub and Jira issue tracking?▼

Git worktree automation integrates directly with GitHub and Jira CLIs to resolve references and fetch metadata. It clones repositories if missing and maps issues or PRs to dedicated worktrees and tmux sessions automatically.

What is the best way to clean up git worktrees after a pull request is merged?▼

The best way to clean up git worktrees after a pull request is merged is through automated session lifecycle management. The system removes closed or merged worktrees and kills associated tmux sessions using the maintained registry.

Do I need to manually clone repositories before starting a tmux session for an issue fix?▼

No, you do not need to manually clone repositories before starting a tmux session for an issue fix. The provider integration checks for the repository locally and clones it automatically if missing before creating the worktree.

Why use isolated git worktrees instead of switching branches in a single working copy?▼

Isolated git worktrees prevent branch conflicts, context switching overhead, and lost local state that occur when using a single working copy. Each task receives its own reproducible environment and lifecycle for safer concurrent development.

Related Skills

Explore More Software Engineering Skills→
MohammedSaudAlsahliMohammedSaudAlsahli

project-session-manager

Manage project sessions with git worktrees and tmux.

Community
Advanced
mvillmowmvillmow
18

worktree-switch

List and switch between Git worktrees for parallel development.

Community
Basic
leejaedusleejaedus

project-session-manager

Provisions per-task git worktrees and tmux sessions for development environments.

Community
Advanced
theslashdojotheslashdojo

git-stash

Stash, apply, and list uncommitted Git changes including untracked files.

Official
Intermediate