project-session-manager

Create isolated git worktrees with optional tmux sessions for PRs, issues, and feature branches.

Updated May 17, 2026
One-click install
npx skills add https://github.com/tiankong0101-byte/skills-registry --skill project-session-manager-tiankong0101-byte
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-session-manager
Source: https://github.com/tiankong0101-byte/skills-registry/tree/main/skills/oh-my-claudecode/skills/project-session-manager
Command: npx skills add https://github.com/tiankong0101-byte/skills-registry --skill project-session-manager-tiankong0101-byte

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, jq, tmux, gh, jira.

What problem does it solve?

This Skill removes the friction of creating safe, isolated development environments for issues, pull requests, and features, so work can happen in parallel without cluttering the main checkout.

Core Features & Use Cases

  • Worktree-first session setup: Creates dedicated git worktrees for PR reviews, bug fixes, and feature branches.
  • Optional tmux orchestration: Starts and manages named tmux sessions and can launch Claude Code inside them.
  • Multi-provider support: Handles GitHub and Jira references, with cleanup and status tracking for active sessions.
  • Use Case: A developer can open a PR review, a hotfix, and a new feature branch at the same time, each in its own worktree and terminal session.

Quick Start

Ask the assistant to create a project session for a pull request, issue, or feature using the appropriate reference and 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 worktree sessions for parallel pull request work?

To create isolated git worktree sessions for parallel pull request work, this Skill spins up dedicated branch-specific worktrees and optional tmux orchestration. Each pull request, issue, or feature gets its own independent directory and terminal session.

Can I manage multiple feature branch environments with tmux and Claude Code?

Yes, you can manage feature branch environments with tmux and Claude Code. This Skill starts named tmux sessions for each worktree and can launch Claude Code inside them, enabling parallel development across multiple isolated branches simultaneously.

What's the best way to set up isolated dev environments for GitHub PRs and Jira issues?

The best way to set up isolated dev environments for GitHub PRs and Jira issues is using this Skill's multi-provider reference handling. It requires GitHub and Jira CLI access to fetch issue and PR metadata, then creates dedicated worktrees for each tracking item.

Do I need git worktree and jq installed to manage parallel development sessions?

Yes, you need git worktree support and jq installed. The Skill relies on jq-based registry management to track active sessions, and requires git worktree support to create the isolated branch environments needed for parallel development workflows.

How does session cleanup work when I finish a bug fix in a git worktree?

Session cleanup when finishing a bug fix in a git worktree is handled by the Skill's built-in status tracking and removal logic. It manages the teardown of worktree directories and associated tmux sessions to prevent environment clutter after work is complete.

Why use git worktrees for PR reviews instead of switching branches in a single checkout?

Using git worktrees for PR reviews instead of switching branches prevents main checkout clutter and context loss. This Skill creates isolated directories for each review, hotfix, or feature, allowing parallel workstreams to run simultaneously without interfering with each other.