project-session-manager

Create git worktrees and tmux sessions for PRs, issues, and features.

1|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/Leap0920/Clean-Portfolio --skill project-session-manager-leap0920
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-session-manager
Source: https://github.com/Leap0920/Clean-Portfolio/tree/main/%25USERPROFILE%25/.openclaude/plugins/cache/omc/oh-my-claudecode/4.14.0/skills/project-session-manager
Command: npx skills add https://github.com/Leap0920/Clean-Portfolio --skill project-session-manager-leap0920

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, jq, tmux, gh, jira, and includes scripts (resource) components.

What problem does it solve?

Project Session Manager (PSM) reduces the friction of switching between multiple issues, PRs, and features by automatically creating isolated git worktrees and (optionally) tmux sessions so you can start focused work immediately.

Core Features & Use Cases

  • PR review sessions: Create a dedicated worktree for a GitHub PR and launch Claude Code with PR-specific context.
  • Issue fix sessions: Create an isolated branch/worktree for GitHub issues (or Jira issues when configured) and launch Claude Code with issue-specific context.
  • Feature development sessions: Create a worktree/branch for a named feature and start an implementation workflow with a clear prompt.
  • Session lifecycle management: List active sessions, attach to running tmux sessions, kill sessions, and run cleanup to remove merged/closed sessions.

Quick Start

Start a PR review session by asking for an isolated worktree and Claude task kickoff for PR #123 in your configured project alias.

Frequently Asked Questions about project-session-manager

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

FAQPage Schema
How do I create isolated git worktrees for parallel PR reviews?

You can create isolated git worktrees for parallel PR reviews by referencing a specific PR number or URL, which provisions a dedicated worktree and optionally launches a tmux session with the PR context.

Can I launch a tmux session for feature development automatically?

Yes, you can launch a tmux session for feature development by specifying a named feature, which creates an isolated worktree and kicks off an implementation workflow with a clear prompt.

Does this work with both GitHub and Jira issue tracking?

Yes, this works with both GitHub and Jira issue tracking by parsing issue references, allowing you to create isolated branches and launch context-specific sessions for either platform.

What's the best way to manage multiple concurrent development sessions?

The best way to manage concurrent development sessions is using a locked registry that records session metadata, enabling reliable listing, attaching, killing, and cleanup of merged or closed worktrees.

Do I need tmux and gh installed to use isolated worktree sessions?

Yes, you need tmux and gh installed, along with git, jq, and jira, as these dependencies are required to provision worktrees, parse references, and orchestrate CLI sessions.

How do I clean up git worktrees after a PR is merged?

You can clean up git worktrees after a PR is merged by running the cleanup command, which removes sessions associated with closed or merged references from the locked registry.