project-session-manager

Manage isolated development environments with git worktrees and tmux sessions.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/mrsono0/lectures --skill project-session-manager-mrsono0
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-session-manager
Source: https://github.com/mrsono0/lectures/tree/main/.claude/skills/project-session-manager
Command: npx skills add https://github.com/mrsono0/lectures --skill project-session-manager-mrsono0

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the creation and management of isolated development environments using git worktrees and tmux sessions, allowing developers to seamlessly switch between tasks and projects without context switching overhead.

Core Features & Use Cases

  • Isolated Environments: Create separate worktrees for different tasks (PR reviews, bug fixes, new features).
  • Session Management: Integrates with tmux for persistent, attachable terminal sessions.
  • Provider Support: Works with GitHub and Jira for issue and PR tracking.
  • Use Case: A developer working on a new feature can create a dedicated worktree and tmux session for it, then quickly switch to another session to review a colleague's pull request, all without losing their place in either task.

Quick Start

Use the project session manager skill to create a new session for fixing issue number 42.

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 parallel feature development?

Managing isolated git worktrees for parallel feature development involves creating separate working directories linked to the same repository. This Skill automates that process, pairing each worktree with a persistent tmux session so you can switch between tasks like PR reviews and bug fixes without context switching overhead.

How do I create a tmux session for a specific GitHub issue or pull request?

To create a tmux session for a specific GitHub issue or pull request, this Skill integrates directly with the `gh` CLI. It automatically resolves the PR or issue reference, creates a dedicated git worktree for the branch, and launches an attachable tmux session mapped to that specific task.

Can I use git worktrees with Jira for tracking issue branches?

Yes, you can use git worktrees with Jira for tracking issue branches. This Skill supports Jira by integrating with the `jira` CLI, allowing you to automatically resolve Jira issue references and spin up isolated development environments mapped directly to your tracked tickets.

Do I need tmux and gh installed to manage development environments with this Skill?

Yes, you need tmux and gh installed, along with git and jq. These dependencies are required because the Skill relies on tmux for persistent terminal sessions, gh for GitHub reference resolution, and jira for ticket tracking to seamlessly create and manage your isolated workspaces.

What is the best way to switch between bug fixes and new features without losing terminal state?

The best way to switch between bug fixes and features without losing terminal state is using git worktrees combined with tmux. This Skill creates dedicated worktrees and tmux sessions for each task, allowing you to detach and reattach to persistent environments seamlessly.

Why use git worktrees instead of cloning multiple repositories for different tasks?

Using git worktrees instead of cloning multiple repositories saves disk space and keeps branches synchronized within a single repository. This Skill leverages worktrees to provide isolated directories for separate tasks while integrating with tmux to maintain persistent session states across switches.