project-session-manager

Create isolated git worktrees with optional tmux sessions for PR reviews.

3|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/marcmunoz-uno/jailbreak --skill project-session-manager-marcmunoz-uno
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-session-manager
Source: https://github.com/marcmunoz-uno/jailbreak/tree/main/skills/project-session-manager
Command: npx skills add https://github.com/marcmunoz-uno/jailbreak --skill project-session-manager-marcmunoz-uno

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing parallel issue, PR, and feature work is painful when you need clean git isolation, consistent environments, and quick context switching without constantly re-cloning or manually juggling branches.

Core Features & Use Cases

  • Worktree-first session management: Create dedicated git worktrees per PR review, issue fix, or feature branch, keeping work isolated and reproducible.
  • Optional tmux orchestration: Automatically create and manage tmux sessions for each worktree so you can attach/detach without losing context.
  • Provider-aware references: Support GitHub by default and optionally Jira issues via configured project aliases, while still cloning from the required git repo.
  • Lifecycle operations: List active sessions, attach/kill sessions, and clean up merged/closed items.

Quick Start

Start a PR review session for omc#123 by running: /psm review omc#123

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 pull request reviews?

To manage isolated git worktrees for pull request reviews, this Skill spins up dedicated worktree environments with optional tmux sessions. It parses references like owner/repo#number or GitHub URLs to create isolated branches for each PR review automatically.

What is the best way to switch between multiple feature branch tmux sessions?

The best way to switch between feature branch tmux sessions is using the built-in session registry. The Skill orchestrates tmux session lifecycles, allowing you to list active sessions, attach to specific worktrees, and detach without losing your development context.

Can I use Jira issue IDs to start feature development worktrees?

Yes, you can use Jira issue IDs to start feature development worktrees. The Skill supports provider-aware references like PROJ-123 through configured project aliases, while still cloning the required git repository to establish the worktree.

How do I clean up git worktrees after merging an issue fix?

To clean up git worktrees after merging an issue fix, the Skill provides lifecycle operations to clean up merged and closed items. You can list active sessions and kill the associated tmux sessions and worktrees when the work is complete.

Does project session management work without manually re-cloning repositories?

Yes, project session management works without manually re-cloning repositories. The Skill creates isolated git worktree environments per feature branch or issue fix, preventing the need to re-clone while keeping work reproducible and cleanly separated.