project-session-manager

Orchestrate isolated git worktree and tmux development sessions with a central registry.

Updated Feb 14, 2026
One-click install
npx skills add https://github.com/shaun0927/codex-superskills --skill project-session-manager-shaun0927
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-session-manager
Source: https://github.com/shaun0927/codex-superskills/tree/main/skills/project-session-manager
Command: npx skills add https://github.com/shaun0927/codex-superskills --skill project-session-manager-shaun0927

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manage isolated development environments using git worktrees and tmux sessions to prevent cross-project contamination and to enable parallel work across multiple tasks.

Core Features & Use Cases

  • Git worktree management for PR reviews, issue fixes, and feature development to isolate work.
  • Tmux session orchestration (optional) with a central registry to track active sessions.
  • Codex runtime launch per session for consistent tooling and execution.
  • Cross-provider integration (GitHub/Jira) to fetch PRs/issues and coordinate cleanup.
  • Safe, root-validated worktree deletion to prevent accidental data loss.

Quick Start

Create a new isolated development session by mounting a git worktree for your project and starting a tmux session with Codex.

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 parallel git worktrees for multiple features without cross-project contamination?

You can manage parallel git worktrees by orchestrating isolated development environments with tmux sessions and a central registry. This prevents cross-project contamination by registering each workspace atomically and enforcing safe, root-validated worktree deletion.

Can I launch a Codex runtime automatically when starting a tmux session for a feature branch?

Yes, you can launch a Codex runtime per session. The workflow enforces Codex launches alongside tmux orchestration for each isolated git worktree, ensuring consistent tooling and execution across your parallel development tasks.

What is the best way to coordinate worktree cleanup after finishing a Jira issue or GitHub PR review?

The best way to coordinate cleanup is using cross-provider integrations with GitHub and Jira. This Skill fetches PRs and issues to track active sessions in a central registry, enabling safe, root-validated worktree deletion to prevent accidental data loss.

How does tmux session orchestration work with isolated git worktrees?

Tmux session orchestration works by attaching a dedicated tmux session to each atomic git worktree registration. This isolates multi-repo workflows like PR reviews and feature development, tracked centrally to prevent cross-project contamination across parallel tasks.

Do I need a central registry to track active workspaces when using git worktrees for development?

You need a central registry to track active worktrees and tmux sessions. It coordinates atomic session registration, manages cross-provider GitHub and Jira integrations, and validates safe worktree deletion to prevent cross-project contamination and accidental data loss.