project-session-manager

Create isolated git worktrees and tmux sessions for Claude Code tasks.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the pain of context switching and tangled local changes by creating isolated git worktrees and optional tmux sessions for each issue, PR, or feature you need to work on with Claude Code.

Core Features & Use Cases

  • Worktree-first isolation: Keeps each task’s code changes confined to its own dedicated git worktree, reducing conflicts between concurrent fixes and reviews.
  • PR review sessions: For GitHub PRs, fetches PR metadata, creates a review worktree, and prepares a PR-focused task context for Claude Code.
  • Issue fix and feature sessions: For issues (GitHub or Jira), creates a fix worktree/branch and primes Claude with issue details; for features, creates a feature worktree and starts an implementation workflow.
  • Optional tmux orchestration: Uses tmux session names and a registry so you can attach, list, kill, and clean up sessions later.

Quick Start

Start with omc teleport when you want an isolated issue/PR/feature worktree before adding tmux/session orchestration by running a command like: omc teleport #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 parallel PR review and issue fixes?

You can create isolated git worktrees for parallel PR review by providing a reference like owner/repo#number or a URL. The tool fetches the required repo state and renders a task context template directly into a dedicated worktree.

Can I use tmux sessions to manage multiple Claude Code worktrees?

Yes, you can use tmux sessions to manage multiple Claude Code worktrees. The tool provides optional tmux orchestration that maintains a session registry, allowing you to attach, list, kill, and clean up isolated workspaces.

What is the best way to run unattended Claude Code feature development across multiple repositories?

The best way to run unattended Claude Code feature development is using deterministic session orchestration. It launches Claude with unattended permission flags inside isolated feature worktrees across multiple repositories to prevent tangled local changes.

Does this session management approach work with both GitHub and Jira issue references?

Yes, this session management approach works with both GitHub and Jira issue references. It parses provider-specific reference formats to create a dedicated fix worktree and primes Claude with the specific issue details before starting the workflow.

How do I clean up finished git worktrees and kill associated tmux sessions?

To clean up finished git worktrees and kill associated tmux sessions, you use the tool's session registry and cleanup operations. This ensures that isolated PR and issue workspaces are safely detached and removed after your work is complete.