project-session-manager

Create isolated git worktree and tmux sessions for PR reviews and issues.

Updated Feb 20, 2026
One-click install
npx skills add https://github.com/ssccio/cc-on-web-base --skill project-session-manager-ssccio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-session-manager
Source: https://github.com/ssccio/cc-on-web-base/tree/main/skills/project-session-manager
Command: npx skills add https://github.com/ssccio/cc-on-web-base --skill project-session-manager-ssccio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of switching contexts by automatically creating isolated git worktrees and tmux-backed development sessions for pull requests, issues, and features.

Core Features & Use Cases

  • Isolated PR review sessions: Create a dedicated worktree from a PR branch and open a tmux session so you can review code without disturbing your main checkout.
  • Issue fix sessions: Create a feature branch/worktree for an issue, launch a tmux session, and keep ongoing work separate and repeatable.
  • Parallel feature development: Start feature branches in isolated worktrees to support multiple tasks at once across projects/repos.
  • Lifecycle management: List, attach to, kill, and cleanup sessions (including merged/closed detection via provider CLIs).

Quick Start

Ask for a PR review session 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 create isolated git worktrees for PR review without disturbing my main checkout?

Creating isolated worktrees for PR review involves fetching the PR branch via provider CLIs and launching a dedicated tmux session, keeping your main checkout undisturbed.

Can I manage multiple feature development sessions in parallel across different repositories?

Parallel feature development is supported by creating isolated worktrees and deterministic tmux sessions across multiple projects, enabling rapid context switching.

Does project session manager work with Jira issue tracking and GitHub CLI?

GitHub CLI is used to fetch PR and issue details for session creation, while optional Jira issue tracking support enables parallel context switching across tracked issues.

What is the best way to clean up tmux sessions and git worktrees after a PR is merged?

Lifecycle management detects merged or closed branches via provider CLIs to clean up tmux sessions and remove associated worktrees, ensuring no stale environments remain.

How do I attach to or kill an existing issue fix session from the terminal?

Attaching to or killing an issue fix session requires parsing registered session metadata to locate the deterministic tmux session name, executing attach or kill operations directly.

Why do I need to parse user references like omc#123 before starting a feature branch worktree?

Parsing user references like omc#123 is necessary to fetch correct PR and issue details via provider CLIs, ensuring the feature branch and worktree are accurately generated.