project-session-manager

Provision isolated git worktrees paired with tmux sessions for parallel development.

38.5k|3.5k|Updated Jan 9, 2026
One-click install
npx skills add https://github.com/Yeachan-Heo/oh-my-claudecode --skill project-session-manager-yeachan-heo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-session-manager
Source: https://github.com/Yeachan-Heo/oh-my-claudecode/tree/main/skills/project-session-manager
Command: npx skills add https://github.com/Yeachan-Heo/oh-my-claudecode --skill project-session-manager-yeachan-heo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Project Session Manager (PSM) centralizes development in isolated environments using git worktrees and tmux sessions, allowing teams to work on multiple tasks without conflicting codebases or tool states.

Core Features & Use Cases

  • Create per-task worktrees and attach tmux sessions to manage concurrent work.
  • Automatically fetches branches, setups, and baselines from origin to keep work-in-progress sessions aligned.
  • Supports PR review, issue fixes, and feature development workflows with project aliases.
  • Use-case example: a developer working on three features across different repos can run separate PSM sessions to keep contexts, branches, and Claude Code instances isolated.

Quick Start

  • psm review omc#123
  • psm fix omc#42
  • psm feature omc add-webhooks

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 multiple git worktrees in parallel for different features?

To manage multiple git worktrees in parallel, you can pair each worktree with a dedicated tmux session. This setup isolates branches, codebases, and tool states, allowing concurrent work on multiple features without context switching or conflicts.

How do I set up isolated dev workspaces for concurrent PR reviews?

Setting up isolated dev workspaces for PR reviews involves provisioning per-task git worktrees and attaching dedicated tmux sessions. This keeps each PR's context, branch, and Claude Code instance completely separate across different repositories.

Do I need tmux to manage git worktree sessions?

Tmux is optional but recommended for managing git worktree sessions. While the core functionality relies on git worktree support to isolate codebases, tmux provides the dedicated terminal sessions needed to launch separate Claude Code instances concurrently.

Can I use GitHub CLI to fetch PR data for tmux session worktrees?

Yes, you can use the GitHub CLI to fetch PR data for tmux session worktrees. The system uses GitHub CLI or Jira CLI to automatically fetch branches, setups, and baselines from origin to keep work-in-progress sessions aligned.

What is the best way to isolate development environments across multiple repositories?

The best way to isolate development environments across multiple repositories is centralizing them with git worktrees and tmux sessions. This method manages concurrent work by creating per-task worktrees that automatically fetch branches and baselines from origin.

Why does my parallel work conflict when switching git branches in the same directory?

Parallel work conflicts when switching git branches in the same directory because tool states and codebases overlap. Using per-task git worktrees with dedicated tmux sessions isolates contexts, preventing conflicts across concurrent development tasks.